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FOREWORD 

This is Revision 1 of Volume II of the two volume User's Reference Manual for 
Compiler Monitor System (CMS-2) for use with AN/UYK-7 Computer . This 
volume contains a description of the languages recognized by the Compiler and 
Assembler , including a comprehensive description of macro generation. It 
also contains a complete functional description of the AN/UYK-7 Computer 
Instruction Repertoire. (Volume I describes the Monitor, Loader, Librarian, 
Peripheral Utilities, and System Operation.) 

Revision 1 incorporates changes 1,2, and 3 to the original document (NAVSHIPS 
0967-028-0060). The reader will find the changed pages clearly indicated through- 
out the volume. 

A document related to Volume II is the Compiler Monitor System-2 (CMS-2) 
User's Reference Manual, Volume I, M-5012. This document describes the 
CMS-2 language as it is used in the preparation of programs for the CP-642B- 
hosted CMS-2/XCMS-2 compilers. 
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SECTION 1 
INTRODUCTION 

1.1 PURPOSE AND SCOPE 

This user's reference manual contains the information required by programmers and 
operators who wish to use or control the operation of the Compiler-Monitor System 
(CMS-2) developed for use with the AN/UYK-7 Computer. Univac Systems Programming 
Group developed this system for the Department of the Navy, Naval Ship Systems 
Command, under contract number N00024-70-C-1142. 

This manual consists of two volumes with contents as follows: 

Volume I - Monitor, Loader, Librarian, Peripheral Utilities, and System 
Operation - contains descriptions of command formats 
recognized by the Monitor, Loader, Librarian, and 

Peripheral Utilities. This volume also contains 
descriptions of calling sequences required to reference 
Monitor service routines and descriptions of operator 
commands recognized by the CMS-2. 

Volume II - Compiler, Assembler, and Instruction Repertoire - contains a 
description of the languages recognized by the Compiler 
(both high level and low level) and the Assembler, 
including a comprehensive description of macro generation. 
Volume II also contains a complete functional description 
of the AN/UYK-7 Computer instruction repertoire. 

While this manual contains comprehensive descriptions of command syntax, 
calling sequences, and messages generated by various components of the system, 
detailed descriptions of the functions performed by each component, the inter- 
faces between the components, and functions performed by the hardware are all 
beyond the scope of this manual. 
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1.2 APPLICABLE DOCUMENTS 

The following documents augment the content of this manual to provide a 

complete description of the Compiler-Monitor System 2 (CMS-2) developed for the 
AN/UYK-7 Computer: 



NAVSHIPS 0967-029-5430 
Program Specification for 
Compiler-Monitor System 
for use with the AN/UYK-7 
Computer. 



NAVSHIPS 0967-029-5440 
Program Design Plan for 
Compiler-Monitor System 
for use with the AN/UYK-7 
Computer. 



NAVSHIPS 0967-051-6291 
AN/UYK-7 Digital Data Computer 

Univac DSD Document, PX 3699A 
UNIVAC 9 1532 Input/Output 
Console Technical Description 

Univac DSD Document, PX 3662 

UNIVAC® 1540/1541 Magnetic 

Tape Units Technical Description 



Consists of five parts containing 
the basic functional specifications 
for each of the five major com- 
ponents in the system: 

Part 1 - Compiler 

Part 2 - Librarian 

Part 3 - Monitor 

Part 4 - Loader 

Part 5 - Peripheral Utilities 

Consists of five parts containing 
the detailed descriptions of 
functions performed by each of the 
five major components in the system: 

Part 1 - Compiler 

Part 2 - Librarian 

Part 3 - Monitor 

Part 4 - Loader 

Part 5 - Peripheral Utilities 

Contains the hardware description 
of the computer used by the system. 

Contains the hardware description 
of the I/O console used by the 
system. 

Contains the hardware description 
of the magnetic tape units used 
by the system. 
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Univac DPD Document, UP2543, Rev 1, 
UNIVAC® 1004 Card Processor Reference 



Contains the hardware description 
of the card reader, card punch, 
and high-speed printer used by 
the system. 



1.3 SYSTEM CAPABILITIES 

CMS-2, also referred to as the system, provides optimum utilization of the 
AN/UYK-7 Computer and associated peripherals in a serial batch processing 
environment. The system is user oriented and designed to optimize the 
capabilities of the system for all users. Its major features are: 

1. Provides the simplest possible operational characteristics 
consistent with the full utilization of the system. 

2. Provides a simple yet flexible means of generating, storing, and 
updating computer programs at the individual installation. 

3. Provides a broad and easily utilized system of program construction, 
manipulation, and debugging aids. 

1.3.1 Hardware Requirements 

The system operates on an AN/UYK-7 Computer and its associated peripherals. 
The minimum equipment required to efficiently operate the system consists of: 

1. AN/UYK-7 Computer with 3 memory banks. 

2. UNIVAC^ 1004 Card Reader, Punch, and Printer or equivalent. 

3. Six UNIVAC^ 1240 or 1540 Magnetic Tape Transports or equivalent. 

4. UNIVAC® 1532 Input/Output Console and Keyboard or equivalent. 
Figure 1-1 illustrates a typical minimum configuration. 
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1532 I/O 
Console and 
Keyboard 




AN/UYK-7 
Computer 
with 48K 
of Memory 




1004 Card Reader 
Punch, and 
Printer 



* Optional 
addition 



... < 

Figure 1-1. Typical Minimum Configuration 



11-1 



-4 



M-5035 



1.3.2 Software Components 

A software component of CMS-2 is a program which is designed to perfqrm a 
specific function (e.g., compile a program, build a library) using an 
external data-base (e.g., source, object code). The component is designed 
to operate under the Monitor (a component that performs control functions) 
which determines its final operational allocation and provides it with a 
centralized input/output capability. Thus, a component represents a module 
in the system which may be tailored to operate under the Executives with 
little anticipated change in the logic. These changes would necessarily 
reflect the idiosyncrasies of the particular executive, notably in the area 
of the Executive call. CMS-2, for the initial development, consists of the 
following components: 



1. 


Monitor 


2. 


Object Code Loader 


3. 


Librarian 


4. 


Peripheral Utilities 


5. 


Compiler 


6. 


Assembler 


7. 


System Tape Generator 



The system utilizes magnetic tape as the system storage medium. The tape 
format effectively provides the features which follow: 

1. Efficient run time retrieval of programs. 

2. Independent system initialization. 

3. Potential system expansion. 

4. Total system delivery. 

5. Complete system update, maintenance and reproduction. 

The system storage medium consists of two parts: 1) the operational library 
and 2) the system library. 
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The operational library contains the Monitor and components which make up the 
system; in addition, it contains directory information required for locating 
programs on the operational library, for relocatable loading (not instruction 
modification), and for initating execution. This library occupies the first 
file on the system tape and is written in a format compatible with the NDRO 
bootstrap routine. The Monitor and the directory information are loaded when 
the bootstrap routine is initiated from the computer control console. This 
provides the independent system initialization. 

The system Library contains the following: 

1. Object code of all run time routines (implicit). 

2. Object code of all intrinsic built-in routines. 

3. Object code of Monitor and all components. 

4. Compools of selected data designs for Monitor and components. 

1.3.2.1 Monitor 

The Monitor (described in Volume I, Section 2) is a serial batch processing 
operating routine utilizing a single AN/UYK-7 unit processor. Major functions 
available through the Monitor are requested by the user through control cards 
described in Volume I, Section 2. The Monitor includes the Centralized Input/ 
Output Module which supports I/O on the various devices attached to the 
AN/UYK-7. The Monitor also provides for handling of all classes of processor 
interrupts and interfaces to allow user programs to access vital interrupt 
information (e.g., floating point error). The Monitor is responsible for 
retrieval of components from the operational library on the system storage 
medium ( system tape) . It also maintains system core allocation algorithm. 

1.3.2.2 Object Code Loader 

The Object Code Loader (described in Volume I, Section 3) performs instruction 
modification to object code produced by the CMS-2 Compiler and CMS-2 
Assembler. The Loader allows optimum code to be generated by the AN/UYK-7 
language processors by combining independently compiled program segments 
under a common base register or registers, thus reducing the number of base 
register manipulation instructions which must be executed. 
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1 .11.2.3 Librarian 

The Librarian (described in Volume I, Section 4) provides a convenient, easy- 
to-use method of storing, retrieving, and updating both source statements and 
relocatable object code. The Librarian is capable of updating (i.e., adding, 
deleting, changing) both entire elements or individual items within an element 

1.3.2.4 Peripheral Utilities 

The Peripheral Utilities (described in Volume I, Section 5) provide a 
variety of* functions for manipulating data files on the peripheral devices. 
These functions include: 

1. Position specified magnetic tape at the start of a file (designated 
by a f i le mark) . 

2. Position specified magnetic tape at the start of a record within 
a file. 

3. Transfer tape data into memory (read tape). 

4. Transfer memory data onto tape (write tape). 

5. Compare the contents of two tapes and print out any differences. 

1.3.2.5 Compiler 

The Compiler (described in Volume II Sections 2 through 10) accepts both high 
and low level languages. The high level language is statement oriented and 
the low level is computer instruction mnemonic oriented. These languages 
describe the desired program, and the Compiler generates object code data that 
the Object Code Loader places into memory as an executable program. The 
Compiler input is called source code and the Compiler output is called object 
code. 
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1.3.2.6 Assembler 

The Assembler (described in Volume II, Section 11) accepts a computer instruc- 
tion mnemonic oriented language that gives the programmer absolute control of 
the structure of his program. In addition, the Assembler provides programmers 
with a level of assistance beyond that normally associated with an assembler 
class of language processors. The assembler accepts programmer definitions 
of pseudo-operations (called Macros) and then uses the definition whenever 
the programmer references the pseudo-operations. As with the Compiler, the 
Assembler input is called source code and the Assembler output is called 
object code. 

1.3.2.7 System Tape Generator 

The System Tape Generator (described in the System Programmer's Manual) 
provides an easy-to-use method of updating system tapes that have a directory 
scheme identical to the CMS-2 tape. The System Tape Generator accepts input 
that contains the necessary data to change tape directory information (e.g., 
number assigned to a new component, names of new records, names of records to 
be deleted), and then, in conjunction with the Object Code Loader, generates 
a new system tape complete with required directories. 

1.4 SYSTEM OPERATION 

System operation consists of initiating the system, preparing inputs to the 
system, and accepting outputs. 

1.4.1 System Load and Initiation 

System loading is initiated using the AN/UYK-7 Magnetic Tape Hardware Bootstrap 
Program. The resident Monitor is loaded at a specified location dependent on 
the number of operable memory banks currently available. The necessary allo- 
cation-dependent words in the resident Monitor are then initialized. The 
Monitor's data and the operational library directory for the Monitor are then 
loaded from the system tape, and the Monitor requests the current time, date, 
operating mode (open or closed shop), and standard selections of input/output 
devices. Any other flags or variables maintained by the Monitor and requiring 
initialization are preset. 
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1.4.2 Standard Input Processing 

Once initiated, the Monitor starts reading card image data from the selected 
standard input device. This device is normally the card reader; however, i he 
Monitor accepts commands to process data from either magnetic tape or the I/O 
console as standard input data. In each of these cases! the input data must 
be in card image format. 

The data read from the standard input device consists of: 

1. Monitor control cards which contain commands to the Monitor including 
commands to load and activate other system components or user programs. 

2. Inputs to an activated system component or user program which contain 
both commands to the program and input data to be processed by the 
program. 

In general, when the Monitor passes control to either another system component 
or user program, the component or program (as applicable) starts reading data 
from the standard input devices; for example, the card images following the 
image commanding the Monitor to load and activate the Compiler make up the 
source code input to the Compiler. On the other hand, most of the card images 
following the image commanding the Monitor to load and activate the Librarian 
are commands to the Librarian directing its manipulation of data stored on 
magnetic tape. 

1.4.3 Standard Output Processing 
The system has three basic outputs: 

1. Standard output consisting of object code cards normally produced on 
the card punch. The Monitor accepts a command to place this data on 
magnetic tape in object code card image format instead of punching 
cards . 

2. Hardcopy output consisting of high-speed printer-oriented data, such 
as program listings, normally produced on the UNIVAC^ 1004 High 
Speed Printer. The Monitor accepts a command to place this data on 
magnetic tape in printer format instead of printing the data. 

3. Console messages consisting of up to 72 characters of operator- 
oriented data (request to mount a tape) typed out on the I/O console. 
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SECTION 2 
INTRODUCTION TO THE CMS -2 LANGUAGE 

2.1 MAJOR FEATURES OF CMS -2 

CMS-2 is a problem-oriented compiler language developed to meet the needs of 
real-time data processing and scientific applications. Its major features 
are described below: 

a. CMS-2 permits program, modularization and adherence 
to the concepts of structured programming. 

b. Input to the CMS-2 Compiler is statement-oriented, rather 
than card-oriented. The source card format is free-form 
and may be arranged for user convenience. 

c. A broad range of data types is definable in CMS-2. These 
types include fixed-point, floating-point, Boolean, 
Hollerith (character), and status. 

d. CMS-2 permits direct reference to, and manipulation of, 
character and bit strings. 

e. Programs may include segments of symbolic machine language, 
referred to as direct code. 

The remainder of this section presents a number of definitions, discusses 
various concepts fundamental to the CMS-2 language, and presents a summary of 
the specific capabilities of the language. 

2.2 PROGRAM STRUCTURE 

A CMSr-2 program is composed of an orderly set of statements. These statements 
are composed of various symbols that are separated by delimiters . Three 
categories of symbols are processed: operators, identifiers, and constants. 
The operators are language primitives assigned by the Compiler to indicate 

r 
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specific operations or definitions within a program. Identifiers are the 
unique names assigned by the programmer to data units, program element s, and 
statement labels. Constants are known values, and may be numeric (decimal or 
octal), Hollerith strings, status values, or Boolean. 

CMS-2 statements are written in a free format and terminated by a dollar sign. 
Several statements may be written on one card, or one statement may cover 
many cards. A statement label may be placed at the beginning of a statement 
for reference purposes. 

The collection of program statements developed by the programmer for input to 
the CMS-2 Compiler is known as the source code for a program and is composed 
of the following two basic types of statements: 

1. Declarative statements - Provide basic control information to 

the Compiler and define the structure 
of the data associated with a particular 
program. 

2. Dynamic statements - Cause the Compiler to generate execut- 

able machine instructions (object code) 
for a program. 

These instructions, when executed at program run time, manipulate the data 
to solve the desired problem. 

Declarative statements defining the data for a program are grouped into units 
called data designs. Data designs consist of the precise definition of 
temporary and permanent data storage areas, input areas, output areas, and 
special data units such as program switches. The dynamic statements that 
cause manipulation of data or express calculations to solve the programmer's 
problems are grouped into procedures. These data designs and procedures 
may be further grouped or classified to form elements of a CMS-2 program. 
At compi le-time , the CMS-2 Compiler recognizes a system as any collection of 
program elements that may be compiled as an entity independent of any inter- 
facing program elements. A compile-time system may comprise an entire 
execution package or it may be only a small part of a large program. 
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Before presenting any further discussion concerning the classification and 
grouping of procedures and data designs into elements and the combining of 
these elements to form systems, several concepts fundamental to the CMS-2 
language must be explored. 

2.2.1 Organization and Classification of Identifiers 

The CMS-2 Compiler uses several conventions to classify data definitions and 
program identifiers that are defined in a user's program. These techniques 
assist the programmer in structuring his program and simplify the development 
and maintenance of the programs. 

2.2.1.1 Forward and Backward References 

The order in which definitions and references to these definitions appear in 
the source input to the Compiler is quite important. All data units are 
defined in data designs. Within the data design where it is defined, an 
identifier may generally be referenced either before it is defined (a forward 
reference) or after it is defined (a backward reference). However, references 
to data from outside a data design can only be backward; that is, the data 
must have already been defined before it can be referenced. Since data 
definitions always appear in data designs, and since data references usually 
appear in procedures, procedures generally follow the data designs defining 
the data referenced by the procedure. 

References to statement labels within procedures and calls to procedures may 
be forward or backward, but must obey the following local/global limita- 
tions . 

2.2.1.2 Local and Global Definitions 

The Compiler further structures the referencing of identifiers by classifying 
all identifiers in a program as either local or global. Local definitions 
are those identifiers that can be referenced only from within the system 
element where they are defined. Global definitions are those identifiers 
that can be referenced both from inside the element where defined and from 
outside by subsequent system elements in the source input stream. 
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Figure 2-1 is a pictorial representation of a CMS-2 compile-time system con- 
sisting of three elements: A, B, and C. Since a definition in the CMS-2 
language is said to be local if it is valid only within a single element of 
the system, any definition valid within element B of Figure 2-1 is said to 
be local to element B. A global definition in the system of Figure 2-1 is 
valid within elements A, B, and C. 

An alternative definition of the term "system" can be derived from this local- 
global concept, i.e., a system is the largest global area within a CMS-2 
compilation. 




Figure 2-1. CMS-2 Compile-Time System 



2.2.1.3 External References and Definitions 

The CMS-2 Compiler provides the capability of compiling one or more elements 
of a large system independently. For example, all three elements of the 
system of Figure 2-1 could be compiled together as a single compile-time 
system. Alternatively, elements A and B could be compiled together as a 
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cumpi lo-timc system and then element C could be compiled separately as another 
compile-timo system. The compiler-produced output in each case is the computer- 
executable instructions (object code) for the various system elements. Later, 
the object code for elements* A, B t and C may be combined by a relocatable 
linking loader program and executed together. 

Presumably, there is some cross-referencing of data and procedures between 
the three elements of our example. In order to compile element C separately, 
any references made by element C to definitions in elements A and B must be 
handled in a special manner by the Compiler and the Loader. References of 
this type are called external references because they involve definitions 
that are external to element C and, in this case, external to the compile- 
time system as well. Those definitions in elements A and B that are referenced 
externally by element C are called external definitions because they are 
definitions that are available to elements external to A and B. 

There are various ways in which definitions and references may be declared 
external. In some cases the Compiler will automatically treat a definition 
or a reference as being external. In other cases, external references and 
definitions must be explicitly declared by the programmer. 

It should be noted that only global definitions may be externally referenced 
or defined. Local definitions are never valid outside, or external to, the 
element in which they are defined. 

2.2.2 CMS-2 Elements 

As described in the previous paragraphs, data designs may be grouped or 
classified to form elements of a CMS-2 program. One or more elements then 
make up a compiler- time system. The ordering and content of program elements 
is subject to the rules governing range and classification of definitions. 

The two types of elements within a compile-time system are system data designs 
and system procedures. System data designs contain global data definitions. 
System procedures contain one or more procedures and may also include local 
data design packages. A local data design, as the name implies, contains 
data definitions that are local to the system procedure in which the local data 
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design appears. This structuring of data designs and procedures into program 
elements within a system is illustrated in Figure 2-2. 



System 



System Procedure 



Procedure 



System Data Design 



Local Data Design 



Figure 2-2. Structuring of Data Designs and Procedures 

The hierarchy shown in Figure 2-2 indicates that, within a system, system 
data designs are equal in importance to system procedures; they are the 
program elements of a system. Keeping in mind the restrictions against 
forward referencing, a source deck may take various forms, as illustrated 
in Figure 2-3. 

The technique illustrated in Figure 2-3 (A) is often used in constructing a 
program. Since definitions within a system data design are global to the 
balance of the system, system procedures may appear in any order following 
the system data design(s) defining the referenced data. Interspersing data 
designs and procedures as in Figure 2-3 (B) (C), however, has an advantage, 
especially in a large system, of maintaining data definitions in meaningful 
groups close to the associated procedures. 

Note that Figure 2-3 illustrates several examples of a compile-time system, 
but these systems might be only a small part of an entire execution package 
In addition, each compile-time system of Figure 2-3 might be further broken 
down into two or more compile-time systems. In this manner, corrections 
may be made to a particular system procedure, which may then be recompiled 
without compiling the entire execution package again. 
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System 
Data Design 
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System Procedure 



System Procedure 



System Procedure 



System 
Data Design 



System Procedure 



System 
Data Design 



System Procedure 



System Procedure 



System Procedure 



System 
Data Design 



System Procedure 



System 
Data Design 



System Procedure 



Figure 2-3. Source Deck Forms 

System data designs and system procedures are the smallest program units that 
may be compiled individually. A compile-time system may consist of a single 
system data design or system procedure, but it cannot consist of a single 
local data design or procedure. 



2.2.2.1 System Data Designs 

Data designs contain descriptions of the attributes of the various data units 
(e.g., tables and variables) and their relationship to each other. As the 
Compiler processes these descriptions, it assigns and reserves core storage 
locations for subsequent references to the data units. Data designs may 
contain value information as well, which will cause the Compiler to generate 
object code to preset the data. 
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Definitions within a system data design are global to the system. They are 
all automatically externally defined by the Compiler. There is, therefore/ 
no need to specifically externally define any data within a system data 
design . 

2.2.2.2 System Procedures 

System procedures are composed of procedures and local data designs. A 
system procedure usually contains one procedure with a name identical to that 
of the system procedure name. This procedure is known as the prime procedure 
of that system procedure. The prime procedure entry point is automatically 
externally defined by the Compiler and is global to the system. Other system 
procedures, and data designs may reference prime procedures at will. Thus, 
the prime procedure of a system procedure is considered a global procedure 
(hence, the term system procedure) . 

A system procedure may contain more than one procedure, as illustrated in 
Figure 2-4. 



Local Data Design 






Procedure A 






Procedure B 






Local Data Design 






Procedure C 


J 





System 
Procedure 



Figure 2-4. System Procedure Design 

For example, the system procedure of Figure 2-4 contains three procedures and 
two local data designs. If this system procedure were named "B" , procedure B 
would be the prime procedure of the system procedure and its name would be 
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global to the entire system. However, procedures A and C, along with the 
data units of the two data designs, would be local to the system procedure 
and could not be referenced from outside the system procedure. 

2.2.2.2.1 Local Data Designs . The difference between system data designs 
and local data designs is that, while system data design definitions are 
global to the system and automatically externally defined, local data design 
definitions are local to the system procedure within which they are contained; 
any necessary external definitions must be explicitly indicated within the 
data design. In addition, a local data design may not be compiled separately 
from its associated system procedure. 

The local data design is intended to be used for the definition of data units 
referenced only by the procedures within its system procedure. The use of 
local data designs reduces the possibility of duplication of data names in a 
large system because of their limited range of definition. 

2.2.2.2.2 Procedures . Procedures contain CMS-2 statements and machine- 
language statements. They may not contain data definitions or data values 
for previously defined data. Procedures contain the statements from which 
the Compiler generates the instructions that actually perform the steps 
necessary to the solution of the problem. They must be included within a 
system procedure element at compi le-time. 

2.2.3 Range of Identifiers 

As can be seen from the previous discussions, the organization of CMS-2 
statements into system data designs and system procedures to form the 
elements of a program is closely related to the rules concerning classification 
of identifier definitions and references. These rules on the range of 
identifiers (i.e., local/global definitions and forward/backward references) 
are summarized in Figure 2-5. 
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Identifiers 



Range Within Which 
They Can Be Referenced 



Prime Procedures 



Throughout the compile-time system. 



Global 



Data defined in a 
System Data Design 



Within that system data design 
and in all system elements that 
follow. 



Local Procedures 



Within the same system procedure. 



Data defined in a 
Local Data Design 



Within that local data design and 
the remainder of the system procedure 
containing the local data design. 



Local 



All Statement Labels 



Within the system procedure. 



Figure 2-5. Range of Program Identifiers 



2.3 DECLARATIVE STATEMENTS 

The CMS-2 declarative statements provide the Compiler with information about 
program structure and data element definitions. Declaratives generally do not 
result in executable code. Declaratives are classified in three categories: 
pro.jrnri .structure declaratives, data declaratives, and Compiler directive 
(or program control) declaratives. 

2.3.1 Program Structure Declaratives 

In the development of a CMS-2 program, the dynamic and data definition state- 
ments are organized into procedure and data design packages. CMS-2 program 
structure declaratives are used to define the source program organization by 
specifically delimiting the structure type as shown in Figure 2-6. An 
.example ..of the correct organization of program structure declaratives for a 
compile-time system is presented in Figure 2-7. 
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Beginning Delimiter 

SYSTEM 

SYS-DL) 

SYS-PROC 

LOC-DD 

PROCEDURE 

FUNCTION 

SYS-PROC-REN 

AUTO-DD 

HEAD 



Ending Delimiter 

END-SYSTEM 

END-SYS-DD 

END-SYS-PROC 

END-LOC-DD 

END-PROC 

END-FUNCTION 

END-SYS-PROC 

END-AUTO-DD 

END-HEAD 



Purpose 

Delimits a compi le-time system 

Delimits a system data design 
within a compile-time system 

Delimits a system procedure 
within a compile-time system 

Delimits a local data design 
within a system procedure 

Delimits a procedure within a 
system procedure 

Delimits a function within a 
system procedure 

Delimits a reentrant system 
procedure within a compile- 
time system 

Delimits a reentrant data design 
within a reentrant system 
procedure 

Delimits a header package within 
a compile-time system 



Figure 2-6. CMS-2 Program Structure Declaratives 
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2.3.1.1 Procedure Structure Declaratives and Linking 

The dynamic statements that describe the processing operations of a program 
are grouped into blocks of statements called procedures. The overall 
purpose of a program, its design, and to some extent, its size, influence 
the programmer's decision as to whether one or several procedures will be 
declared. The transfer of program control from one procedure to another 
requires the observance of procedure linking rules for such transfers. 

The concept of procedure linking may best be described by posing a situation 
from which those linking requirements desirable for use by a programmer may 
be derived. As a program design develops, it becomes apparent to the 
programmer/designer that there is a requirement to execute a given set of 
statements at several points (within several procedures) in the total program. 
As each of these points is encountered, it would be advantageous to have a 
program control capability of branching to a common routine (procedure), 
processing, and returning to the next instruction following the program 
control branch point (or procedure call). Along with this procedure call 
should be a capability of simultaneously and automatically passing that 
data, from the calling procedure to the called procedure where the data 
is processed. This automatic data transfer is defined as input of para- 
meters, that is, data input to the called procedure from the calling pro- 
cedure. 

Upon completion of processing by the called procedure, it also should be 
possible to automatically pass the results of the processing from the called 
procedure to the calling procedure when program control is returned to the 
calling procedure. This is defined as output of parameters, that is, data 
output to the calling procedure from the called procedure. 

Additionally, there should be a capability of specifying an instruction 
address (statement label) to which the called procedure may transfer program 
control in the event it does not perform its normal processing due to invalid 
input data or processing checks indicating invalid or illogical results. 
This is defined as an abnormal exit (abnormal return). 
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The foregoing is the capability available to provide linkage among all 
procedures. Furthermore, all or part of these linkage capabilities may be 
used, depending upon the requirements of the program. The syntactical 
requirements for defining a procedure and making a procedure call are 
presented in Sections 4 and 5, respectively. Figure 2-8 is a schematic 
representation of the procedure linkage concept. 

2.3.1.2 Reentrant System Procedures 

Certain programming applications require that one or more of the procedures 
comprising the program package or system for that application be structured 
such that they may be shared by more than one task concurrently. Procedures 
of this type are said to be reentrant procedures. 

The principal characteristic of a reentrant routine is that it must be divided 
into two logically and physically distinct parts: a constant part and a 
variable part. The constant part (instruction part) is loaded into memory 
once and services all tasks requiring this routine. One copy of the variable 
part (data area) belongs to each task that is being serviced. This copy is 
usually created (that is, it is allocated memory space) when the task is 
initiated. 

Within the CMS-2 language, a programmer has the capability of declaring a 
system procedure to be reentrant. In this case, the object code generated 
by the Compiler for all procedures within this system procedure will be 
invariant (constant) under execution. In addition, a special type of local 
data design called an automatic data design may be declared within a reentrant 
system procedure. An automatic data design is used for the definition of 
temporary storage and procedure parameters used by the reentrant procedures 
within the system procedure. Within a reentrant system procedure, the 
Compiler automatically performs the required separation of the constant part 
(procedures) and the variable part (automatic data designs). Multiple copies 
of the variable part may then be loaded into memory along with a single copy 
of the constant part and the reentrant system procedure may be executed 
simultaneously by more than one task or central processor. 

I 
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Figure 2-8. Statement Execution Flow Involving Procedure Calls 
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It must be clearly understood that the Compiler provides only this separation 
capability. The responsibility for loading these programs into memory and 
allocating space for automatic data designs is properly a function of loaders, 
monitors, and executive programs. Furthermore, the CMS-2 language and 
Compiler provides the capability, through this separation function, of 
implementing such sophisticated programming techniques as recursion and 
reentrance after suspension. However, much of the responsibility for this 
type of programming must be borne by the programmer/designer and the executive 
program for the application. 

2.3.2 Data Declarations 

Data declarations by the programmer define the format, structure, and order 
of data elements within a compile-time system. The three major data types 
are as follows: 

1. Switches: 

a. Statement switches. 

b. Procedure switches. 

2. Variables: 

a. Computational: 

1. Integer. 

2. Fixed-point. 

3. Floating-point. 

b. Non-computational: 

1. Hollerith. 

2. Boolean. 

3. Status . 

3. Tables: 

a. One-dimensional. 

b. Multidimensional (array) . 

c. Subtables . 
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d. Like-tables. 

e. Item areas. 

f. Fields. 

2.3.2.1 Switches 

Switches provide for the transfer of program control to a specific location 
within a compile-time system. Switches contain a set of identifiers, or 
switch points, to facilitate program transfers and branches. The switch 
points represent program addresses of statement labels or procedure names. 
Transfer of control to a particular switch point is usually determined by 
the value of a programmer-supplied index. 

2.3.2.2 Variables 

A variable is a singular piece of data. It may be one bit or multiple bits 
or words. A variable may be preset to a desired value within the definition 
statement. The variable may contain a constant value or its value may 
continuously change during program execution. Multiple variables having 
identical attributes may be defined in a single declarative statement. Data 
types that may be specified for a variable are arithmetic (fixed- or floating- 
point) , Hollerith (character string), status (defined states of condition) , or 
Boolean (true or false). An initial value, or preset, may be specified for 
the variable in the declarative statement. 

2.3.2.3 Tables 

Tables hold ordered sets of identically structured information. The common 
unit of data structure in a table is the item. An item consists of k computer 
words where k is selected by the programmer or Compiler. A table may contain 
n items, where n is programmer selected. Thus the size of the table in 
number of required computer words for storage becomes the product of n and k. 
A table structure is illustrated in Figure 2-9. 
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Figure 2-9. Table Structure 
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Items may be subdivided into fields. Fields are the smallest subdivision 
of a table. A field may be a partial word, a full word, or a multi-word 
subdivision. Data types that may be specified for a field are arithmetic 
(fixed- or floating-point) , Hollerith (character string) , status (defined 
states of condition), or Boolean (true or false). Fields may overlap each 
other. Data may be preset into a field. An example of field assignments 
is illustrated in figure 2-10. 
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Figure 2-10. Field Assignments for a Table 
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CMS-2 tables may be defined as horizontal or vertical. This specification by 
the programmer dictates the manner in which the table words will be stored in 
core. The words of a horizontally declared table are stored such that words 
of all items are stored sequentially, followed by words 1 of all items, etc. 
The words of a vertically defined table are stored such that all words of 
item are stored sequentially, followed by all words of item 1, etc. Figure 
2-11 illustrates the storage pattern for horizontal and vertical storage. 



Item 
Item 1 




Horizontal Storage Vertical Storage 



Figure 2-11. Table Storage Sequence 
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The CMS-2 table structure also allows the programmer to define a subset of 
adjacent items within a table as a subtable. The programmer may also allocate 
outside the table a working storage area, designated as an i tern-area, which will 
automatically take on the same field format as that defined for the table 
items. Additionally, the programmer may declare tables known as like-tables 
having identical field format as the parent table but having a different 
number of items. Figure 2-12 illustrates these described relationships to 
the parent table. 

2.3.2.4 Arrays 

An array is an extension of the table concept for storing ordered sets of 
identically structured information previously defined as items. Arrays may 
be conceptually vi sualized as rows, columns, and planes of items. An example 
of an array (three-dimensional) is presented in Figure 2-13. As with tables, 
the basic structural unit of an array is the item. The array item may 
consist of k computer words with fields defined as desired. The pattern 
for storage of an array within core is illustrated in Figure 2-14. 

2.3.3 Compiler Directive Declaratives 

Certain CMS-2 declarative statements specify control information to the 
Compiler. These declaratives direct Compiler action as to allocation mode, 
listing options, system index registers, program debug features, base number- 
ing system interpretation, data pooling requirements, and the computer mode of 
operation within which the designated program is expected to run. These 
declarative statements may be located in major headers if the control applies 
to the entire compile-time system, in minor headers if the control applies 
to a system element, or within a system element. The rules for placement 
and range of effective action for the individual declaratives are defined 
fully in Section 7. 
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Figure 2-14. Array Storage Sequence 
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2.4 DYNAMIC STATEMENTS 

CMS-2 dynamic statements specify processing operations and result in executable 
code generation by the Compiler. A dynamic statement consists of an operator 
followed by a list of operands and additional operators. An operand may be a 
single name, a constant, a data-element reference, or an expression. 

2.4.1 Expressions 

Arithmetic expressions may include standard addition, subtraction, multiplica- 
tion, and division operators, as well as exponentiation, mixed-mode values, 
and inline redefinition of the scaling of fixed-point numbers. An algebraic 
hierarchy of operation evaluation is used. A relational expression performs 
a comparison between two similar operands as specified by a relational 
operator. There are four types of comparisons available: 

1. Arithmetic, involving the comparison of signed arithmetic values 
(fixed, floating, or mixed). 

2. Hollerith, involving a left-to-right, character-by-character 
comparison. 

3. Boolean, involving single bit comparisons. 

4. Status, involving the comparison of status values. 

Arithmetic operators used in CMS-2 are + (addition), - (subtraction), 

/ (division), * (multiplication), ** (exponentiation), and (inline scaling) . 

Relational operators are EQ (equal), NOT (not equal), LT (less than), GT 
(greater than) , LTEQ (less than or equal) and GTEQ (greater than or equal). 
Boolean operators used in CMS-2 are AND, OR, XOR (exclusive or) and COMP 
(logical not). A CMS-2 expression may include algebraic, relational, and 
Boolean operators. 

2.4.2 Statement Operators 

The CMS-2 statement operators allow the programmer to write his program in an 
easy-to-learn , problem-oriented language. Major CMS-2 operators and their 
functions are summarized on the following page. 
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Operator Funct ion 

SET Performs ealculat ions or assigns a value to one or more 

data units. The assignment may be? arithmetic, Hollerith, 
status, Boolean, or multi-word. 

SWAP Exchanges the contents of two data units. 

GOTO Alters program flow directly or via a statement switch. 

IF Expresses a test situation for conditional execution of 

one or more statements. 

VARY Establishes a program loop to repeat execution of a 

specified group of statements. 

FIND Searches a table for data that satisfies specified conditions. 

PACK Transfers bit strings into a data area. 

SHIFT Shifts a string of bits. 

FOR Selectively executes one of a set of statement 

blocks based on the value of a controlling expression. 



2.4.3 Special Operators 

Special operators are available in CMS-2 to facilitate references to data 
structures and operations on them. These operators and their functions are 
summarized below. 



Operator Function 

BIT To reference a string of bits in a data element. 

CHAR To reference a character string. 

CORAD To reference a core address. 

ABS To obtain the absolute value of an expression. 

POS, FIL To position a magnetic tape file. 

LENGTH To obtain an input/output file length. 

CNT To obtain a count of bits set. 

) CAT To concatenate character strings. 
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2.5 HIGH-LEVEL I INPUT/ OUTPUT STATEMENTS 

CMS-2 high-level input/output (I/O) statements permit the program to communicate 
with various hardware devices while running in a non-real-time environment 
under a Monitor system. When CMS-2 I/O statements are used by the programmer, 
the Compiler generates specific calls to run-time routines that must be 
loaded with the user's program. The run-time routines are designed to link 
with the Monitor system and communicate with its I/O drivers. I/O declarative 
and dynamic statement operators and their associated functions are summarized 
below. 



Operator 
FILE 

OPEN 
CLOSE 

INPUT 

OUTPUT 

FORMAT 

ENCODE 

DECODE 

ENDFJLE 
CHECK I D 
DEFJD 



Funct ion 

Defines the environment and pertinent information concerning 
an input or output operation, and reserves a buffer area 
for record transmission. 

Prepares an .external device for I/O operations. 

Deactivates a specified file and its external device, if 
appropriate. 

Directs an input operation from an external device to a 
FILE buffer area. 

Directs an output operation from a FILE buffer area to an 
external device. 

Defines the desired conversion between external data blocks 
and internal data definitions. 

Directs transformation of data elements into a common area, 
with -conversion in accordance with a specified FORMAT. 

Directs unpacking of a common area and transmittal to data 
units as specified by a FORMAT declaration. 

Places an end-of-f i Je mark on appropriate recording mediums. 
Directs checking an ID header or label on a file. 
Directs the output of an ID header on a file. 
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2.6 PROGRAM DEBUG FACILITIES 

CMS-2 debug statements may be placed in the source language of a user's 
program to assist in program checkout. These statements may reference any 
data units defined within the system. Machine code is generated by the 
Compiler to call on run-time debug routines. The debug routines communicate 
with the Monitor system during program execution to print the desired checkout 
data onto the system output device (high-speed printer) . 

Five program checkout statements are provided. Output code is generated only 
if the corresponding statements are enabled in the program header information. 
A programmer may then control and select the debug tools as needed. The debug 
operators and their functions are summarized below. 

Operator Function 

DISPLAY Causes the contents of machine registers and/or specified 

data units to be formatted and printed on the system output. 

SNAP The contents of a data unit are printed and stored. Sub- 

sequent executions cause a printout only when the data 
contents are modified. 

RANGE A high and low value are specified for a data unit. Each 

time the data is modified in the program, a message is 
printed if the value falls outside the range. 

TRACE A printout is generated for the execution of each CMS-2 

statement between TRACE and END-TRACE boundaries. 

PTRACE Each CMS-2 procedure call encountered in the program being 

executed is identified by calling and called procedure 
names . 
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SECTION 3 
BASIC DEFINITIONS 

A CMS-2 program consists of an ordered set of sentences composed of symbols 
and delimiters. The symbols and delimiters are formed using characters from 
the CMS-2 alphabet. 

3.1 CMS-2 ALPHABET 

The CMS-2 alphabet consists of letters, digits, and marks as described below: 

a. Letter - One of the 26 letters of the English alphabet, A 

through Z, written in capital letter form. 

b. Digit - One of the ten Arabic numerals, through 9. 

c. Mark - Any additional special character that may be input 

to the Compiler via the Monitor I/O routines. The 
commonly used marks that have significance to the 
CMS-2 Compiler are listed below, along with their 
common name: 

.+ (plus) ) (right parenthesis) 

(minus) $ (dollar sign) 

/ (slash) , (comma) 

* (asterisk) ' (prime) 

(decimal point, period) A (space) 

( (left parenthesis) (space) 



3.2 SYMBOLS 

CMS-2 symbols are composed of strings of one or more letters, digits, or marks 
from the CMS-2 alphabet. There are three types of symbols: 

1. Operators - Indicating operations or specifications. 

2. Identifiers - Names by which programs reference their 

environment. 

3. Constants - Words that represent unchanging values (constants 

in the mathematical sense). 
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3.2.1 Operators 

Operators are symbols that denote an action or delineation to the Compiler. 
They tell the Compiler "what to do" or "what it is" as opposed to other 
symbols that tell "where it is" or "how much it is". 

The following symbols are examples of CMS-2 operators; the symbols are divided 
into five categories: 



Ari thmetic 



/ 



Relational 

EQ 
LT 
GT 



Boolean 

AND 
OR 

COMP 



Dynamic 

PROCEDURE 

FIND 

SET 



Declarative 

TABLE 
FIELD 
LOC-DD 



A special class of operators provides machine control interface. These symbols 
are entirely machine dependent. For the AN/UYK-7 Computer, these symbols are: 
KEY1, KEY2, KEY3 , STOP, ST0P5, STOP6, and ST0P7. 



3.2.2 Identifiers 

Identifiers are arbitrary names used to label various units of a CMS-2 program 
so that these units may be referred to by unique names. A name is composed of 
from one to eight letters and digits; the first character of a name must be a 
letter c All CMS-2 identifiers (except statement labels, procedure names, and 
abnormal exits) must be defined by or within a data declaration, which assoc- 
iates the identifier with its specific attributes. 

In order to prevent ambiguities in the source input for a CMS-2 program, the 
Compiler does not allow the programmer to declare or define identifiers that 
duplicate operator symbols in the CMS-2 language. Appendix D presents a list 
of those symbols which are reserved words. These reserved words are not 
available to the programmer for use as identifiers. In addition, any programmer 
expecting to make use of CMS-2 run-time routines (high-level debug, input/ 
output, or mathematical routines) should avoid the use of identifiers beginning 
with the characters "RT". This will prevent possible conflict at load time 
with global identifiers defined and referenced within the CMS-2 run-time 
library. 
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3.2.2.1 Statement Label 

A statement label is a special identifier in a CMS-2 program; the statement 
label is used to label a dynamic statement. A statement label derives its 
definition by context, since it is always followed immediately by a period. 

When reference is made to the statement label during an operation within the 
program, the period is omitted and the label is then known as a statement 
name. More than one statement label may be applied to a dynamic statement. 

NOTE 

Statement labels may appear only on dynamic 
statements. Hence, the period following a name 
signifying a statement label may be used only 
between the PROCEDURE and END-PROC declarations 
and may never be used with direct code statement 
labels. 

3.2.3 Constants 

A constant denotes a value that is known at compilation time. CMS-2 programs 
manipulate the following four types of data: 

1. Numeric values consisting of rational numbers. 

2. Hollerith or literal values consisting of strings of characters 
from the CMS-2 alphabet. 

3. Status values consisting of independent sets of arbitrarily 
named conditions. 

4. Boolean values consisting of the two values: true or false. 

3.2.3.1 Numeric Constants 

A numeric value, positive or negative, may be represented by a decimal or 
octal constant as described below: 

1. Decimal - Consists of one or more base-10 digits (0-9). This 
is the normal mode of the Compiler, The number 
enclosed in parentheses, preceded by the letter D, 
is also acceptable and may be used when a non-decimal 
mode is specified to the Compiler (see Section 7). 
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2. Octal - Consists of one or more base -8 digits (0-7) enclosed 
in parentheses and preceded by the letter O. 

These constants may be preceded by a plus sign if positive and must be preceded by a 
minus sign if negative. 

A radix point appearing within or at the beginning of the constant identifies the constant 
as a mixed number or fraction. The number of fractional bits attributed to the constant 
equals: 

1. 3. 2 *n+l truncated to an integer, if constant is decimal, or 

2. 3 *n, if constant is octal 

where n is the number of fractional digits. If the radix point is omitted or occurs at 

the end of the constant, it identifies the constant as an integer (whole number). 

Examples 

a. -94 (negative decimal integer) 

b. 0(77) (positive octal integer) 

c . 88.1 (positive mixed decimal number) 

d. -0(.64) (negative octal fraction) 

e. -LK492.3) (negative mixed decimal number) 

To avoid writing many zeros, it is sometimes convenient to express a very large or 
very small numeric constant as a coefficient multiplied by an exponent. 
Examples 

a. ,00023 8 = .23 8 * 10 Q " 3 = 0(.23E-3) 

b. 18U0000 10 = 18 1(J * 10 f) = 18E5 

c. 15000 ■ = 1,5 10 * 10 4 = 1.5E4 

d. 7300 Q = 7.3 8 * 10 8 3 . = 0(7. 3E3) 

Both the coefficient and the exponent must have the same case. If the number is octal, 
it must be preceded by the O descriptor. 

3.2.3. 2 Hollerith Constant 

A Hollerith constant is composed of a string of characters enclosed by parentheses and 
preceded by the descriptor H. 
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Examples 

1. H(NOTNOW) 

2. H (REWIND AA) 

3. HO) LAST) 

In the second example, the two blanks are considered part of the constant. 
The third example illustrates the use of a right parenthesis as part of 
the constant within a string of characters. Each right parenthesis must 
be represented by two consecutive right parentheses since the string is 
terminated by a single right parenthesis. Encoding this constant results 
in the characters: 

) LAST 

Any character, including blank, is a valid character in the Hollerith 
set and may be used in source programs to construct character-string 
constants. 

NOTE 

If a Hollerith constant appears as the last term of a 
parenthesized expression, at least one blank must 
separate the right parenthesis signifying the end of 
the Hollerith constant from the right parenthesis 
signifying the end of the expression. 

3.2.3.3 Status Constants 

A status constant is a mnemonic used to describe one of the possible values of 
a data unit. The Compiler assigns a unique value (beginning with zero) to each 
status constant that is associated with a data unit. In subsequent statements, 
as the programmer sets and tests the data unit using the mnemonic, the Compiler 
substitutes the assigned value to differentiate possible conditions. Status 
constants must be unique for a given data unit but may be reused for other 
data units . 

A status constant may be composed of any characters of the CMS-2 alphabet with 
the exception of a single prime (*). The status constant may have the same 
number of characters as an identifier. Status constants are always enclosed 
by single primes, as illustrated on the following page. 
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•REPAIR' 
'STANDBY ' 
'ALERT' 
'AIRBORNE * 

3.2.3.4 Boolean Constants 

A Boolean constant denotes one of the logical values of Boolean algebra (true 
or false) and is represented as a binary integer: 

Logical Binary 

True 1 
False 



3.3 DELIMITERS 

Blanks serve to separate symbols in a CMS-2 program. When used as a separator, 
a single blank accomplishes the same result as a sequence of two or more 
blanks. All marks described in paragraph 3.1 may be used as delimiters. 
Some marks, such as $, have unique delimiting uses. When a mark appears 
between two CMS-2 symbols, blanks are not needed as separators although they 
may be used if desired. 

3.<1 STATEMENTS 

CMS-2 statements are dynamic and declarative and are composed of a string of 
symbols and delimiters. In general, a declaration defines a structural con- 
figuration of data and a dynamic statement defines the processing operation 
that manipulates the data. All CMS-2 statements are terminated by a dollar 
sign ($J . More than one statement may appear on one card and a statement may 

be continued on several cards. Null statements are recognized by the compiler 
when a statement terminator is immediately followed by a statement terminator 
and is otherwise syntactically correct. 

3.5 COMMENTS 

Comments, intended as clarifying text, have no operational effect on a program 
and may be included in either of the following two ways. 
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1. Within a statement by enclosing the comment within two 
consecutive single-prime symbols, as illustrated below: 

VRBL Z r'NTEGER" 14 "BITS" S"IGNED" $ 

NOTE 

A symbol may not be broken by this type of comment; 
i.e., V"A"R"IA"BL"E" would not result in the symbol 
VRBL. 

2. As a separate statement the use of the operator, COMMENT: 
COMMENT THIS ROUTINE COMPUTES SQUARE ROOTS $ 

NOTE 

A dollar sign may be expressed within either type of comment 
by coding it as two consecutive dollar signs. 

3.5.1 Special Comments 

Comments beginning in card column 11 (the first column of the statement field) 
are treated as special cases by the Compiler. If the statement is one of the 
following, the Compiler performs the indicated action on the listing: 

Input Action 

COMMENT &(( EJECT $ Eject to the top of the next listing page. 

COMMENT a( (LINE* $ Print a line of asterisks (*) . 

COMMENT a( (SKI Pn $ Skip n lines, where n is a number from 1 to 9. 

If a comment statement beginning in card column 11 is not one of the special 
indicators, the Compiler replaces the word COMMENT with a single asterisk ■ (*) 
in column 11 and lists the comment after skipping a line. 

Input : 

COMMENT THIS IS AN EXAMPLE $ 
Output : 

* THIS IS AN EXAMPLE $ 

These special comments allow programmers to produce listings that have a 
greater narrative format than listings without the special comments feature. 
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3.6 SOURCE CARD FORMAT 

All CMS-2 source cards contain a card identification field and a statement 
field. The card identification field occupies columns 1 through 10; the 
statement field occupies columns 11 through 80. 

Card columns 1 through 10 have no operational effect on the Compiler. However, 
the suggested use of the card identification field is as follows: 

a. Columns 1 through 4 - Program identification. 

b. Columns 5 through 8 - Card sequence number. 

c. Columns 9 through 10 - Insert number. 

The statement field has a free format. Statement labels, operands/operators, 
etc., may occur anywhere in columns 11 through 80. Each statement is terminated 
with a $. There can be more than one statement per card or a statement may 
require several cards. No continuation card indicator is needed when a CMS-2 
statement exceeds one card. The statement continues in columns 11 through 80 
of each succeeding card until a dollar sign is encountered. If a symbol or 
contiguous string of characters is to span two cards, the first part must end 
in column 80 of card 1 and the second part must start in column 11 of card 2. 
For example, if the eight-character symbol STMTLAB1 is started in column 78 
of one card, the remaining five characters must begin in column 11 of the 
next card. 

While packing of statements on cards reduces the size of the input deck, the 
CMS-2 Compiler does not format the listing of the input statements. Packed 
statements will appear in the same form on the listing. 
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SUCTION \ 
DECLARATIVES 

The CMS-2 declarative statements provide the Compiler with information about 
program structure and data element definitions. Declaratives generally do not 
result in executable object code. Declaratives may be divided into three 
groups: program structure declaratives, data declaratives, and control 
declaratives. 

4.1 PROGRAM STRUCTURE DECLARATIVES 

The following program structure declaratives are used to define the organization 
of a CMS-2 program: 

a. SYSTEM and END-SYSTEM statements delimit a compi le-time system. 

b. HEAD and END-HEAD statements delimit headers within a compi le- 
time system. 

c. SYS-DD and END-SYS-DD statements delimit a system data design 
within a compile-time system. 

d. SYS-PROC (or SYS-PROC-REN) and END-SYS-PROC statements delimit 
a system procedure within a compile-time system. 

e. LOC-DD and END-LOC-DD statements delimit local data designs 
within a system procedure. 

f. AUTO -DD and END -AUTO -DD statements delimit automatic data 
designs within a system procedure. 

g. PROCEDURE and END-PROC statements delimit procedures within a 
system procedure. 

h. FUNCTION and END -FUNCTION statements delimit functions within 
a system procedure. 

Each of these statements is discussed in detail in the following paragraphs 
in the order in which they generally occur in a CMS-2 source program (see 
Section 2 for further information on program organization) . 
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4.1.1 System Declarative (SYSTEM) 

The SYSTEM declarative specifies the beginning of a ..compile- time system. This 
must always be the first statement of a CMS-2 source program. 

Format 

name SYSTEM key -specification comments $ 
Explanation 

Name The identifier by which this system is known. 

SYSTEM Declares a compile-time system to be known by the 

identifier above. 

Key specification Optional (see Section 7 for explanation). 
Comments Programmer remarks. Optional. 

4.1.2 Head Declarative (HEAD) 

The HEAD declarative serves to identify a group of major or minor Compiler 
control statements/The major header control statements of a compile-time 
system must immediately follow the SYSTEM declarative and must be terminated 
with an END-HEAD declarative. Minor header control statements immediately 
"precede the system data design or system procedure to which they apply. 
Since the HEAD declarative is primarily for library control purposes, its 
use in source input to the Compiler is generally optional (see Section 7 for 
further information on the HEAD statement). 

Format 

name HEAD key-specification comments $ 
Explanation 

Name The identifier by which this header is known. 

HEAD Declares a major or minor header. 

Key specification Optional (see Section 7 for explanation). 

Comments Programmer remarks. Optional. 
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•1.1.3 End' Head Declarative (END-HEAD) 

This declarative terminates a major or minor header within a compile-time 
system. Its use is required after major header control statements but is 
optional after minor header control statements. 

Format 

END-HEAD name $ 

Explanation 

END-HEAD Declares the end of a header. 

Name The header identifier. Optional. 

Example 
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4.1.4 System Data Design Ueclarative (SYS-DD) 

This declarative specifies the beginning of a collection of data element 
definitions that are global to the system; that is, these data elements are 
known to all system procedures that follow in the compile-time system. A 
system data design is a basic element of a CMS-2 program. 

Format 

name SYS-DD key-specification comments $ 
Explanation 

Name The identifier by which this system data design is known. 

SYS-DD The system data design declarative. 

Key specification Optional (see Section 7 for explanation). 
Comments Programmer remarks. Optional. 

4.1.5 End System Data Design Declarative (END -SYS -DP) 

This declaration terminates a system data design within a compile-time system. 
Format 

END-SYS-DD name $ 
Explanation 

END-SYS-DD Declares the end of a system data design. 

Name The identifier by which this system data design is known. 
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•].].<> System Procedure Declarative (SYS-PKUC) 

System procedures consist, of one or more procedures or functions and may 
contain one or more local data designs. A system procedure is a basic element 
of a CMS-2 program. 

Format 



name SYS-PROC key-specification comments $ 
fcxpl anat ion 

Name The identifier by which the system procedure is known „ 

It also identifies the prime procedure within the system 
procedure. 

SYS-PROC Initiates a system procedure consisting of local data 

designs and procedures. 

Key specification Optional (see Section 7 for explanation). 

Comments Programmer remarks. Optional 

Examples 
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4. 1. 7 Reentrant System Procedure Declarative (SYS-PROC-REN ) 

This declarative specifies the beginning of a special type of system procedure known as a 
reentrant system procedure. The generated code produced by the Compiler for all 
procedures within a reentrant system procedure is invariant under execution (see Section 2 
for a further explanation of reentrant code). A reentrant system procedure consists of one 
or more procedures and may contain one or more local data designs or automatic data designs. 

Format 

Name SYS-PROC-REN key- specific at ion comments $ 
Explanation 

Name The identifier by which the system procedure is known. It also 

identifies the prime procedure within the system procedure. 

SYS-PROC-REN Initiates a reentrant system procedure. 

Key specification Optional (see Section 7 for explanation). 

Comments Programmer remarks. Optional. 



4. 1. 8 Local Data Design Declarative (LOC-DD) 

This declarative specifies the beginning of a set of data element definitions that are valid 
only within the system procedure in which this local data design appears. Such data 
elements must be defined in a local data design before they may be referenced by a dynamic 
statement within a procedure. 

Format 

name LOC-DD comments $ 
Explanation 

Name The identifier by which the local data design is known. Optional. 

The name has relevance when LQCDDPOOL is requested. The 
user must provide a LOC-DD name at compile time if he wants 
to reference the pooled local data design by AC name at load time. 

LOC-DD Declares the start of a local data design. 

Comments Programmer remarks. Optional. 
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4.1.9 Local Data Design Declarative (END-LOC-DD) 

This declarative specifics the end of a local data design within a system 
procedure . 

Format 

END-LOC-DD name $ 

Explanation 

END-LOC-DD Declares the end of a local data design. 

Name The identifier by which the local data design is known. 

Optional. 

4.1.10 Automatic Data Design Declarative (AUTO-DD) 

This declarative specifies the beginning of a set of data element definitions 
that are valid only within the reentrant system procedure in which this auto- 
matic data design appears. An automatic data design may appear only within a 
reentrant system procedure (i.e., it must follow a SYS-PROC-REN declaration). 
All formal input and output parameters and temporary data storage areas used 
by reentrant procedures that follow must be declared between the AUTO-DD and 
END-AUTO-DD declaratives. The allocation for these data areas must be provided 
dynamically prior to or during execution; hence, automatic data designs may 
not contain switch definitions or preset data. 

Format 

name AUTO-DD comments $ 
Explanation 

Name The identifier by which the automatic data design is 

known, 

AUTO-DD Declares the start of an automatic data design within a 

reentrant system procedure. 

Comments Programmer remarks. Optional. 
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NOTE 

Automatic data designs are functionally similar to local 
data designs except that they may be used only wi thin a 
reentrant system procedure and may not contain preset 
data or switches. Automatic data designs should contain 
the definit ions of all data units that are modified during 
execution of reentrant procedures. Local data designs 
may be used within reentrant system procedures for 
defining switches and preset data that are not modified 
during execution . 

4.1.11 End Automatic Data Design Declarative (END -AUTO -DP) 

This declarative specifies the end of an automatic data design within a 
reentrant system procedure. 

Forma t 

END-AUTO-DD name $ 

Explanation 

END-AUTO-DD Declares the end of an automatic data design. 

Name The identifier by which the automatic data design is 

known . 

4.1.12 Procedure (PROCEDURE) and End Procedure (END-PROC) Declaratives 

A procedure is the basic organizational unit of dynamic statements in a CMS-2 
program; it establishes the rules of data manipulation in processing a problem. 
Procedures specify a sequence of operations which appear only once in the 
source program but which may be invoked at various points throughout the 
program. The PROCEDURE declarative specifies the beginning entry point of a 
procedure and supplies further identifying information to the Compiler. The 
end of the procedure is indicated by the END-PROC declarative. Procedures may 
be called by name from other procedures within the same system procedure, or 
from other system procedures if the procedure is externally defined. Procedures 
may have input, output or exit parameters, which are passed from or to the 
calling procedure. 
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Format 



PROCEDURE name INPUT formal-parameters OUTPUT 

formal-parameters EXIT abnormal-exit-name(s) $ 



steps of the procedure 



END-PROC name 
Explanation 
PROCEDURE 

Name 
INPUT 

Formal Parameters 



Delimits (with associated END-PROC) a- procedure 
and establishes an entry point for the procedure. 

An identifier by which the procedure is referenced. 

Optional. Specifies that the list of formal para- 
meters that follows is input to the procedure. 

Optional. Data unit names separated by commas. 
They are input or output parameters that have been 
previously defined in a data design. They establish 
the structure of parameters and provide a legality 
check on procedure calls. Formal parameters may be 
variables, system indexes, entire tables, like- 
tables, subtables, or item areas. They may not be 
subscripted data units, expressions, constants or 
functionally modified data units. A formal para- 
meter may not be a LOC-INDEX. (See paragraph 4.2.2, 
Example 5 for an explanation of the allowable use 
of the CORAD operator in the formal parameter list.) 



I I -4-9 



M-5035 



OUTPUT 



EXIT 



Abnormal Exit Name(s) 



ENU-PROC 



Example 



Optional. Specifies that the list of formal 
parameters that follows is output as a result 
of the procedure operation. 

Optional. Specif ies tha t one or more abnormal 
exit names follow. 

Optional. Identifies the abnormal exit(s). 
Abnormal exit names appear only as operands of a 
RETURN operation within the procedure and must be 
unique. If more than one is specified, they 
must, be separated by commas. 

Specifies the end of the procedure identified 
by name . 
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(stops of procedure! 
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In this example, the name of the procedure is TEST. It has two formal 
input parameters, VI and V2, which will contain input values when the 
procedure is entered. The formal output parameter, VALUE, will be set 
appropriately by the procedure prior to returning to the calling program. 
The two abnormal exit parameters require alternative return points in the 
calling program to be specified when procedure TEST is called. Refer 
to Section f> for -further information on procedure calls. 
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•1.1. Ki Function (FUNCTION) and End Function (END-F UNCTION) Declaratives 

The function is a special class of procedure. While a procedure call has a 
specific CMS-2 statement form (see Section 5) , the function is called 
implicitly by using its name in a dynamic statement in much the same way as 
a data unit is referenced (see Section 5). The steps of the function are 
delimited by the FUNCTION and END -FUNCTION declarations. A function must have 
at least one input parameter and always results in a single output value. The 
function must specify a data unit name or an expression as a parameter on a 
RETURN statement to indicate the output value (see Section 5). A function 
may be the prime procedure or the only procedure of a system procedure if 
desired. 



Format 



FUNCTION name (formal input parameters) type $ 



steps of the function 



END-FUNCTION name $ 
Explanation 
FUNCTION 
Name 

Formal Input Parameters 



Specifies the beginning of a function definition. 
The identifier used to reference the function. 



The names of variables, tables, like-tables, 
subtables, or item-areas that have been previously 
defined in a data design. A function must have 
at least one formal input parameter; if more 
than one is specified, they must be separated 
by commas. 
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Type Optional. Specifies the attributes of the output value of 

the function. When this information is omitted, the attributes 
of the output value are determined by the implied mode of the 
Compiler for variables (a signed 16-bit integer, unless 
superseded by a MODE declaration). When specified, the 
type parameter must be one of the following: 

F Floating-point value 

B Boolean value 

H followed by the number Hollerith value having the 
of characters indicated number of characters 

(not to exceed eight) 

S followed by a list of Status value that can assume 

status constants separated any of the states corresponding 
by commas to the listed status constants 

A followed by the total Fixed-point value 

number of bits (not to 

exceed 64) , the designator 

S or U (signed or unsigned) , 

and the number of fractional 

bits 

I followed by the total Integer value 

number of bits (not to 
exceed 64) , and the desig- 
nator S or U (signed or 
unsigned) 
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Steps of the Function CMS-2 dynamic statements that perform the 

operations of the function. 

END-FUNCTION Specifies the end of the function definition. 

Example 
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In this example, the output value of the function is a signed 32-bit 
integer that depends on the value of the input parameter AZM. 

4.1.14 End System Procedure Declarative (END-SYS-PROC) 
This declarative specifies the end of a system procedure. 

Format 

END-SYS-PROC name $ 

Explanation 

END-SYS-PROC Declares the end of the system procedure. 

Name The name of this system procedure assigned by the SYS- 

PROC statement . 

> 
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4.1.15 End System Declarative (END -SYSTEM) 

This statement declares the end of a compile-time system. 

Forma t 

END-SYSTEM name $ 

Explanat ion 

END-SYSTEM Declares the end of the preceding system. 

Name The name of the system assigned by the SYSTEM 

statement. 

4.2 DATA DECLARATIONS 

Data declarations define the structure and order of data elements within a 
compile-time system and provide a means for referencing these elements. A 
thorough understanding of data declarations is necessary to write efficient 
and accurate CMS-2 programs. 

There are five major types of data declarations in CMS-2: 

1. Variables. 

2. Tables (together with fields, item-areas, subtables, and 
like-tables) . 

3. Indexes . 

4. Swi tches . 

5. Files . 

These declarations, with the exception of files, are discussed in the following 
paragraphs. Files are described in Section 6 with the input/output statements. 

Within any range of definition, no two data elements may have the same name. 
A name defined in a system data design may not be duplicated within the 
compile-time system (or within any system to be loaded simultaneously in 
which the name is externally defined). A data definition made within a local 
data design or a statement label specified within a procedure may not be 
duplicated within that system procedure. 
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An exception is made lor fields. The definition of a field is always local 
to a table. A field name may not be duplicated within the same table, but may 
appear in as many tables as desired. 



4.2.1 Variable Declaration (VRBL) 

A variable 1 is a single quantity of data. The variable name identifies a* given 
location containing the quantity of data. A variable may contain a constant 
value or its value may continually change during program execution. The data 
may occupy one bit, part of a word, one whole word, or many words. 



Variables may be any of the following six data types 

Comput at i onal 



1. Integer 

2. Fixed-Point 

3. Floating-Point 

4. Boolean 

5. Hollerith 

6 . Status 



Non-computational 



Format 



VRBL name(s) type (R) initial-value V(x f y) $ 
Explanation 



VRBL 



Name(s) 



Indicates that the definition of one or more variables 
follows. 

A unique identifier by which the variable is referenced. 
Multiple names (maximum 25) may be specified by separating 
them with commas and enclosing the list in parentheses. 
The Compiler then allocates locations for each of the 
names according to the description (implied or specific) 
that follows. 
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Type 



following: 

Floating-point 

Boolean variable 

Hollerith variable having 
the indicated number of 
characters 

Status variable that can 
assume any of the states 
corresponding to the listed 
status constants 

Fixed-point variable 



Optional. May be one of the 
F 
B 

H , followed by the 
number of characters (not 
to exceed 132) 

S, followed by a list of 
status constants separated 
by commas 

A, followed by the total 
number of bits (not to 
exceed 64) , the designator 
S or U (signed or unsigned) t 
and the number of fractional 
bits 

I, followed by the total 
number of bits (not to 
exceed 64) , and the desig- 
nator S or U (signed or 
unsigned) 

In the absence of a preceding MODE declarative statement 
and in the absence of one of the above listed data type 
specifications, the Compiler will imply and allocate the 
data type as a signed 16-bit integer. 

NOTE 

The descriptors H, A and I may be followed by 
tags representing the various numeric para- 
meters. Tag is defined in Section 7 under the 
EQUALS definition. 



Integer variable 
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W Optional. Only meaningful when the floating-point 

data type is specified. If specified, it indicates thai 
AN/UYK-7 floating-point instructions with rounding arc 
to be used for arithmetic operations on this variable. 

Initial Value Optional. The variable(s) may be preset with this 

parameter. If more than one variable is defined by the 
declaration, all will be preset to the same value. If 
specified, this parameter consists of a F followed by a 
constant (see Example 4, below). The constant must be a 
value compatible with the variable structural definition. 
If the variable is computational, the constant may be 
any numeric constant. 

V(x,y) Optional. Specifies that the variable is to be preset 

to the preceding specified initial value parameter 
according to the magnitude and bit position contained 
within the parentheses. The initial value will be 
computed using the magnitude assigned by the x-parameter 
to the bit position assigned by the y-parameter (see 
Example 10). The magnitude must not exceed 15 bits. 

Examples 

iKASflA iCt/Miffl-Si \Hi i I i i i i m i i i 1 i i i iii i i i I 

The variable CHARS is a Hollerith variable (H) consisting of 80 
characters. 

iV.Mili iCiTifti Id. .4V. .( /. i/uft I*. > i In I 

The variable CTR is identified as being a fixed-point variable (A) . 
There are 24 unsigned bits (U) ; 12 of them are fractional bits. 

lV|*l8llt iCm ftfl 1*1 I I I l M I I I I I I. I I I I I I I II H I ill I 

The variable in this example is named CTR2 and will be assigned by 

the Compiler the implied mode and attributes of a signed 16-bit integer. 
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4. ivi<igiii iP^ki 1F1 .P. ,-0(1/17.. .7, 7,), 1^1 11 I 11 1 1 I 

The variable FLOAT is a floating-point variable. The descriptor P 
indicates that the initial value of the variable is -17.77 octal. 

:.. iVlftftt, / .CiT.M ^ !<L| T|R,1, 3 1 C,T, j tP.T.ff .il) 1 1A1 iJUV, U 1 a, 1P1 ill 

The variables CTR , CTR1, CTR2, PTR1 are all fixed-point (A). They each 
contain 24 unsigned bits and 12 fractional bits. The initial value of 
all the variables is as indicated by the descriptor P. 

6. lVlftfllll l<i*|T|RTg| u 5» 1U1 1*1 I I I » 1 1 » 1 1 » 1 I t 11 l I I I I I I 

The variable INTR is an unsigned integer variable of 5 bits. 

7. 1V1M1I1 l&i°Pl L i iBt 1 Pi liit i 1 i 1 1 1 I 1 1 t » til t i < 

The variable BOOL is a Boolean variable initially set to the true (1) 
condi lion. 

8. iVihftU A. SI Si i VnMiti'i,! , 1 tiQiW, / ^'^UHPlnn', 1P1 i' ifitfitli ,' , 

The variable GAS is a status variable that may assume the three states 
FULL, LOW, and EMPTY. The Compiler will assign values to these three 
states and assign these values to the variable as it subsequently 
encounters these states in conjunction with the variable GAS (for example, 
see the SET statement). The variable will be preset to the value 
associated with FULL. 

Note that the states of a status variable are always enclosed within 
single primes. 

9. iVifliBiLi iPiLiTl 1F1 idfiili frl 1 M \ \ 1 1 1 1 1 \ 1 1 m m 1 1 i i I 

The variable FLT is a floating-point variable. (R) specifies that 
those AN/UYK-7 instructions providing floating-point operations with 
rounding are to be used. 

( 
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. iV,*i8,L, .CiMK.Sig, g, 8, Ut IPi ,1,1 A. fit iV. (U .01^17.) , i I i 

Variable COURSE is an unsigned integer variable, eight bits long. The 

variable is to be preset with the value 112.5. V(180,7) specifies that 

bit 2} is to represent 180. From this specification, bit 2^ = 90 , 

2 5 = 45, 2 4 = 22.5, 2 3 = 11.25, etc. Thus, to preset the value to 

6 4 

112.5 requires bits 2 and 2 to be set (90 + 22.5 = 112.5), as 
illustrated below. 



7 ,p 9 5 9 4 9 3 9 2 9 1 9 






1 





1 














ill 2 






I I I 



The internal representation will be the octal number 120. See Table 
4-1 for further examples. 

4. 2. 1. 1 Parameter Declaration (PARAMETER) 

The PARAMETER statement declares a variable as in the VRBL declaration but in 
addition associates with it registers to be used for parameter passage on any call 
to a procedure (does not apply to function calls) with a formal parameter defined via 
this PARAMETER statement. 

NOTE 

The PARAMETER declaration is designed to accommodate 
users with previously assembled sets of utility routines 
that require specific A-registers for input parameters 
and which output results in specific A-registers. Because 
of this intended use the compiler does not assume the 
responsibility for destruction of partial results held in 
A-registers when formal input or output lists in the 
procedure declaration contain a mix of PARAMETER 
variables and normal variables, or when expressions are 
used as actual parameters when calling a procedure with 
PARAMETER variables in its formal input list. 
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Format 

PARAMETER name type (R) initial-value V(x,y) , register-number $ 
Explanation 

PARAMETER Indicates that the definition of a variable follows. 



Name 

Type 

R 

Initial Value 
V(x,y) 

Register Number 



The explanation of these terms are given in 
paragraph 4. 2. 1 for the VRBL declaration. 
Type may not specify more than two words. 

An integer (0-7) or an EQUALS tag having a 
value (0-7). 



Example 

A comparison of the code generated when using the PARAMETER statement and 



that generated when using the VRBL statement: 

PARAMETER X I 32 S, $ 
PARAMETER Y I 32 S, 6 $ 



Procedure declaration : 



VRBL X 132 S $ 
VRBL Y I 32 S $ 



PROCEDURE P INPUT X OUTPUT Y $ PROCEDURE P INPUT X OUTPUT Y $ 
SA AO, X,K3 



LA A6, Y,K3 
END-PROC 

Procedure call: 

P INPUT A OUTPUT B $ 
LA A0,A,K3 
LBJ B6,P 
SA A6, B,K3 



END-PROC 



P INPUT A OUTPUT B 

LA A0,A,K3 

SA A0,X,K3 

LBJ B6,P 

LA AO, Y,K3 

SA AO, B,K3 
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4.2.2 Table (TABLE) Declaration 

A table is an ordered set of data consisting of equal and adjacent subsets 
(basic units) called items. There is no limit to the number of items within 
a table. 

All items of any one table contain exactly the same number of words and have 
the same data structure. Items are identified sequentially within a table, 
the first item number being and the last n-l f where n equals the number of 
items. An optional counter (the major index) which is Compiler-allocated 
with maintenance responsibility residing with the programmer, may be specified. 
If maintained, it will contain the actual number of items within the table that 
contains meaningful data at any given time. 

A one-dimensional table is arranged in either a vertical or horizontal align- 
ment. The vertical table arrangement of data permits rapid searches on selected 
words of any one item. The horizontal table arrangement of data permits rapid 
searches on one word or one field of all items. 
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TABLE 4-1. EXAMPLES OF VARIABLE DECLARATIONS f 



TYPE OF 
VARIABLE 


FORMAT OF VARIABLE DECLARATIONS 


VRBL 


Name(s) 


Data Type 


Rounding 


Initial 
Value 


Preset 
Scaling 


$ 


Integer 


VRBL 
VRBL 

VllDL 

VRBL 


INTA 

(INTB, INTO 

TNTn 
INTE 


I 5 U 

I 16 S 

T TNTDRTTS 11 

18 U 


y 


P 0(12345) 
P 1.25 


V(.25,0) 


$ 
$ 

$ 


F loat i ng- 
Point 


VRBL 

VRRF 

VRBL 


FLTA 

FI TR 
r LI D 

FLTC 


F 

F 
r 

F 




P 1 9 7^ 
P 15E9 




$ 
«? 
$ 


Fixed- 
Point 


VRBL 
VRBL 


FIXA 

(FIXB, FIXC) 


A 1 1 C A 

A \<L b 4 

A FIXBITS U FIXFRAC 




P 




$ 


Boolean 


VRBL 
VRBL 
VRBL 


BOOLA 
BOOLB 

(BOOLC, BOOLD) 


B 
B 
B 




P 1 
P 




$ 
$ 
$ 


Status 


VRBL 
VRBL 


STA 

(STB, STC, STD) 


S 'LOW , 'MEDIUM' , 'HIGH' 

S 'NONE', 'ONE', 'FEW, 'MANY' 




P 'NONE' 




$ 
$ 


Hollerith 


VRBL 
VRBL 
VRBL 


HOLA 
HOLB 

(HOLC, HOLD) 


H 7 

H HOLCHAR 
H 1 




P H(ABCD) 




$ 
$ 
$ 


Implied 


VRBL 


IMPL 










$ 



NOTES 



1. Tags such as INTDBITS, FIXBITS, FIXFRAC, and HOLCHAR may be used as indicated but must be assigned 
integer values by an EQUALS declaration. 

2. If the type of variable is implied (type-structure omitted) the attributes of the variable are determined 
by the implied mode of the Compiler to be a signed 16-bit integer, unless superseded by a MODE declaration. 
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A multidimensional table (array) is stored forward in memory, in order of 
increasing absolute location, with the leftmost subscript, (which represents 
the row or item) varying most rapidly. Thus, a two-dimensional array may be 
said to be stored in a columnar fashion. All the defined subcomponents of a 
given table (fields, subtables, like-table.s , and item-areas) must be defined 
between the TABLE declaration and its associated END-TABLE declaration. Sub- 
tables and like-tables are not allowed as subcomponents of an array. Sub- 
tables, like-tables, and item-areas cannot be included in a table that is 
variable in length or that uses indirect addressing (INDIRECT). 

In the following discussion of table format, the term tag is indicated as an 
option to specify integer values for the various parameters associated with 
the declaration of a table. When this option is exercised, the value supplied 
by the tag must be provided by an EQUALS declarative (see Section 7). 



Format 



TABLE name storage-type words-per-i tern or packing-descriptor 

INDIRECT number-of-i terns or dimensions major-index-name $ 



Explanation 



TABLE 



Specifies a TABLE declaration. 



Name 



An identifier unique to the TABLE. 



Storage Type 



Specifies the storage alignment desired according 
to one of the following types: 



V 



H 



A 



Horizontal arrangement 

Vertical arrangement 

Array arrangement in n-dimensions 



Words-per-Item 



An integer constant or tag that specifies the num- 
ber of words contained in each item. This value 



cannot be 0. 
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Packing Descriptor 



INDIRECT 



Specifies that the Compiler will compute the 
number of words per item necessary to contain the 
specified fields, as follows: 

Descriptor Result 

NONE Each field is assigned at least a 

full word . 

MEDIUM Each field is assigned the smallest 

available, directly referable word 
fragment that will hold the data. 

DENSE Fields will be packed by the Compiler 

in a dense manner, making optimum use 
of all bits in a word. 

(data type) The Compiler will assign the number 
of words required to accommodate 
the attributes of the specified data 
type (see explanation under FIELD 
declaration for data type). This 
parameter permits referencing a 
single piece of data by item. Field 
declarations must specify starting 
bit and word number when used with 
typed-item tables. 

Optional. Specifies that the table is indirectly 
referenced. Furthermore, no core allocation is 
made, the names and definitions are preserved, and 
the core allocation can be accomplished dynamically. 



i 
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Number of Hems An integer or lay thai specifies the maximum 

number of items in the table. 

Dimensions Integers and/or tags, separated by commas, which 

specify the array dimensions (a maximum of 1) . 

Major Index Name Optional. Defines a unique identifier containing 

the current number of items in the table as main- 
tained by the user. If the major index name is 
specified, the Compiler uses it to determine the 
current number of items in the table containing 
data when searching or moving the table. Use of 
a major index is restricted to V- and H-type tables 
Specification of a major index name constitutes 
a definition of it as a data unit (signed 10-bit 
variable) ; consequently, it cannot appear in any 
other data declarative statement. 

Examples 

iTTAi&Lfi ■ , ftgfrT, A flop, A*>fm 1*1 I . ■ I i ■ I . ■ I 

In this example, the table named DICT is a horizontal table with three 
words per item, 500 items, and a major index named ALPHA. At run time, 
ALPHA contains the current number of items as set dynamically by the 
program. 

The table named IDNS is a vertical table with 1,200 items and is to be 
densely packed. The Compiler computes the words per item based on the 
number and size of the defined fields and performs the dense packing. 

fHAALfi I t l/ti^/r i/ft ,iT 1 i3,y Hx t^i i i I i i i i i i » i » 1 

In this example, an array, ARY, contains five words in each item. Its 
dimensions are 2 by 3 by 4, or 24 items. 
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This example defines an array, RAY, of which each item contains two 
words. Its dimensions are 2 by 3 by 4, or 24 items. The word INDIRECT 
indicates that no core allocation is to be made. All references to 
table RAY will be made by indirect addressing. 

Following is an example of the use of INDIRECT and a major index. 

Assume that a procedure processes data tables of fixed format and 
varying lengths up to a maximum of 100 entries. The data design 
associated with the procedure contains a table declaration: 

TftflMT i \ XTABA Jf y & ATA/MM iWi M . ,1 

This declaration specifies a horizontal table of two words per item, 100 
items maximum, that has not been allocated core storage. The table has 
a major index Jl, which will contain the actual number of items at run- 
time as provided by the dynamic source statements. This declaration may 
be accompanied by FIELD declarations as desired. 

The procedure itself might require as input the location of the calling 
program's data table and the number of items in the following table: 

The calling procedure puts data in its associated data table. The 
procedure OUTDO is then called: 

where MYBUF is the name of the caller's data buffer which has a structure 
compatible with TABA, and BUF ITEMS contains the number of items in MYBUF. 

The procedure OUTDO thus has its TABA defined dynamically as the user's 
data table for this operation of OUTDO. Each subsequent request for 
OUTDO would provide similar entry conditions (see Section 5). 
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6. TABLE TRACK V 1 $ 

The table TRACK is vertical with one word per item. TRACK is a "null" 
table because it is declared with zero items. No core locations will 
be reserved. 

7. TABLE FLOATDAT V (F) 1000 $ 

Table FLOATDAT has been declared vertical and 1,000 items long; the 
type of data associated with the table is floating-point. The Compiler 
will assign two words per item. References to the table may be by item 
and the Compiler will utilize the declared data type (floating-point). 

8. Following is an example of the use of tags within a table declaration: 
NUMWORDS EQUALS 1023 $ 

NUMITEMS EQUALS 25 $ 

TABLE LARGE V NUMWORDS INDIRECT NUMITEMS $ 

In the above example, the names NUMWORDS and NUMITEMS represent 1023 
and 25 respectively. The statement is interpreted as: 
TABLE LARGE V 1023 INDIRECT 25 $ 

The table LARGE is arranged vertically, with 1,023 words per item and 
25 items. Dynamic core allocation is specified by the INDIRECT 
specifier. 

4.2.3 Field (FIELD) Declaration 

The items of a given table may be further subdivided into units called fields . 
Field configurations are identical for all items of a given table. A field 
may occupy a partial word, a whole word, or more than one word. A field 
defined as part of a word must be wholly contained within that word; i.e. , 
it may not cross word boundaries. A field occupying more than one word will 
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be allocated an integral number of words. Multiword fields are not permitted 
in horizontal tables. Field definitions within an item are completely inde- 
pendent of one another and may, therefore, overlap. It is not necessary for 
all of the data within an item to be completely defined by fields. A field 
name is always associated with a particular table, like-table, subtable or 
i tern-area. 

Format 

There are two basic formats for defining fields: 

1 . Type a 

FIELD name data-type (R) word-location starting-bit-position 
initial-value V(x,y) $ 

2. Type b 

FIELD name data-type 
Explanation 



(R) initial-value V(x,y) $ 



FIELD 
Name 



Specifies the FIELD declaration. 

The identifier used to reference the field within the 
table. Field names are local to the table within which 
they are defined. The same names may, therefore, be 
used for fields within various tables. The same name 
may not be duplicated within the same table definition. 



Data Type 



Descriptor 

F 

B 

H followed by the 
number of characters 
(not to exceed 132) . 

S followed by a list 
of status constants 
separated by commas. 



Meaning 

Floating-point field. 

Boolean field. 

Hollerith field having the 
indicated number of characters. 

Status field, which can have any 
of the states from the listed 
status constants . 
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Ucscr i pt or 



Mca ni ncj 



A followed by the 



Fixed-point field. 



(R) 



Word Location 

Starting Bit 
Fosi tion 

Initial Value 



number of bits (not 
to exceed 64) , des- 
ignator S/U (signed 
or unsigned) , and the 
number of fractional 
bits. 

1 followed by the Integer field, 

number of bits (not 
to exceed 64) and 
the designator S/U 
(signed or unsigned) . 



If the data type specification is omitted, the 
field will be assigned the implied mode (i.e., 
by a MODE declaration or Compiler-provided 
signed 16-bit integer). 

Optional. This parameter is meaningful only when a 
floating-point data type is specified. If specified, 
it indicates that AN/UYK-7 floating-point instructions 
with rounding are to be used for arithmetic operations 
of thi s field . 

An integer or tag indicating the word of the item in which 
the field occurs. This value must not be greater than 255. 

An integer or tag specifying the most significant 
bit or sign bit of the field. In an n-bit word, the 
positions are numbered from left (n-1) to right (0). 

Optional. This field may be preset with this parameter. 
If specified, this parameter consists of a P followed 
by one or more constants. These constants must be a 
value compatible with the data type specified for the 



NOTE 
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field. A series of constants, up to a maximum of 255, 
separated by commas, may be specified for multiple oc- 
currences of the field. Constants may be enclosed in 
parentheses and preceded by a repeat factor. 

V(x,y) Optional. This parameter specifies that the field is 

to be preset to the preceding specified initial value 
parameter according to the magnitude and bit position 
contained within the parentheses. The initial value 
will be computed using the magnitude assigned by the 
x-parameter to the bit position assigned by the y- 
parameter (see Example 6). The magnitude must not exceed 
15 bits. 

Type-a fields are used when the programmer wishes to specify the field 
location within an item (programmer packing). 

Type-b fields are used to permit packing to be controlled by the packing 
designator used in the TABLE declaration (Compiler packing). 

The data type may be omitted for both type-a and type-b fields to specify 
use of the implied data type of the Compiler. The implied data type is the 
inherent mode of the Compiler (a signed 16-bit integer) or is specified 
in a MODE declaration. 

Examples of Type-a Fields 

i. ihl^lJk ■ ■ iSCtQL , ii I A , , , , , I , i i . . i , , , I 

The Boolean field, BOOL, occupies the rightmost bit of the second word 
(word 1) of the item. 

a. i/f^.uB , ■ //■ JAQ \ Z Ji> 4, ■ . I , , , , . i i ■ ■ I 

In this example, the Hollerith type field, HOLL, has 120 characters. It 
is located in word 2 of the item and starts in bit position 31. It is 
implied that this is a multiword field requiring the necessary number 
of words to contain the 120 characters. (HOLL would not be allowed in a 
horizontal table.) 
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i i i i . i i i 1 i i i i i i /vttaU.iV.ji i'/Wi'I i4t iii f^i i i i 



The status type field, STAT, may contain only the status constants 
'REJECT', 'ACCEPT' , 'HOLD', or 'FIX'. It is located in word 4 of the 
item and starts in bit position 2. 

4. r . MiW*. id. liVI Si rt. ift *Ji 16 . i . . i . i i I 

In this example, the field ARITH is a signed fixed-point data type having 
24 bits, four of which are fractional. It is located in word of the 
item and starts in bit position 23. 



M I I I I I H I I 1 1 



The field MDHWD starts in bit 15 of word 2 of each item. Its type is 
implied by the Compiler or a MODE declaration and must not conflict with 
the starting bit 15. 

In this example, field MATH is a signed integer, 12 bits long, starting 

at bit 26 of word 1. The first occurrence of this field is to be preset 

8 

to the value of 30 with bit 2 of the field representing the magnitude 

of 12. The result of the preset assignment will show an octal represent- 
ation of 1200 in the field, as illustrated below: 



31 



Word 1 



26 



15 



Word 



Sign Bit 



1 


















































2°, 


.046875 


2l = 


0.09375 


22 .= 


0.1875 


23 = 


0.375 


24 = 


0.75 


25 =■ 


1.5 


26 = 


3 


27 = 


6 


28 .= 


12 


29 = 


24 


2 10 = 


48 
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7. if iL^ifl \FM\I\W\ i \F\ \ A I $1 i i I i i i i i i 

In this example, field FARITH is a floating-point data type, two words 
long, starting at bit 31 of word 0. The (R) signifies that arithmetic 
operations using this field must employ floating-point instructions with 
rounding. Note that a floating-point field must never be defined in a 
horizontal table since the AN/UYK-7 floating-point format requires two 
adjacent computer words. 

Examples of Type-b Fields 

8. I 111 I I I I I I \/\'\ £ \ L A ifol^l A A I II I I 1 I I I I I II I 

This is a Compiler-packed Boolean type field. The associated table must 
have a packing descriptor. 

9. fj'&A ,v.*lMg, M\ ^5| ,P, rdHfiji fflfart),,, rf.f,7,a), 4 

The integer field VALUE will be allocated or packed according to the 
packing descriptor specified in the table declaration. The first 
occurrence of this field in an item will be preset to -145, the next 
three occurrences will be preset to 19, and the following 4 occurrences 
will be preset to 73. 

See Table 4-2 for further examples. 
4.2.4 Item-Area (ITEM-AREA) Declaration 

An item-area is a data set with a structure identical to that of an item of 
the associated (parent) table, with the same number of words and the same 
field configuration. There may be any number of item-areas associated with 
a parent table, but they are physically separated from the table. The item- 
area is a convenient working storage area, assigned by the Compiler, where a 
single item of a table may be temporarily stored for examination, manipulation, 
or accumulation of data. 
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Format 

ITEM-AREA area-name(s) $ 
Explanation 

ITEM-AREA Specifies the ITEM-AREA declaration. 

Area Name(s) The unique name or names, separated by commas, of 

areas of working storage. Each area has the same 
format as an item of the parent table; therefore, 
only the name of each item-area associated with the 
parent table need be specified. 

Examples 

1. XfiFH-iMM, ■ SUfMi ■ I A ■ . , ■ ■ . ■ I . , ■ ■ ■ . ■ ■ ■ I 

A single item-area named BUFFI is defined. 

2 . xrfrtrJABti MfFZjx. MoMi^ #em&T, & , ■ ■ ■ ■ I 

There are three item-areas named BUFF2, W0RK1 , and WORKST. 
4.2.5 Subtable (SUB-TABLE) Declaration 

A subtable is a set of adjacent items, wholly contained within the parent 
table. Its item size and field configurations are identical with those 
defined for the parent table. Except that it lies within the confines of the 
parent table, a subtable is itself a table having its own optional major index 
and stipulated maximum number of items. Subtable definitions within a parent 
table are independent of one another and may overlap. Subtables may only be 
defined for single-dimensional tables (horizontal or vertical tables). 

Format 

SUB-TABLE name initial-i tem-number-of-parent-table 

maximum-number-of-items-in-subtable major-index-name $ 
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TABLE 4-2. EXAMPLES OF TYPE-a FIELDS 



TYPE OF FIELD 


FORMAT OF FIELD DECLARATION 


r I ELD Name 


Data Type 


Rounding 


Location 


Start 
Bit 


Ini tial 
Values 


Scaling 


$ 


Integer 


FIELD INTA 
FIELD INTB 


15 U 
I 64 S 




2 

INTBWL 


15 

INTBST 


P 3(10) 
P 


V(1,0) 


$ 
$ 


F loating Point 


FIELD FLTA 


F 




1 


31 




. 




;$. 


Fixed Point 


FIELD FIXA 
FIELD FIXB 


A 6 U 2 
A 32 S 16 






FIXBLOC 


5 

31 


P 9.548 


XI- 


$ 
$ 


Boolean 


FIELD BOOLA 
FIELD BOOLB 


: 









BOOLBBIT 


P 1,0,1 




$ 
$ 


Status 


FIELD STA 








* 4 


P f 0N' 




$ 


Hollerith 


FIELD HOLA 
FIELD RQLB 


H 40 
H 3 


* 




31 
28 


P H(ABC) 


s 


$ 
$ 


Implied 


FIELD IMPLA 








15 






$ 



NOTES 



1. Tags such as INTBWL, INTBST, FIXBLOC, and BOOLBBIT may be used as indicated but must be assigned 
integer values by an EQUALS declaration. 

2. If the type of field is implied, the attributes of the field are determined by the implied mode 
of the Compiler to be a signed 16-bit integer, unless superseded by a MODE declaration. 

3. If a field starts in the middle of a word, it must be wholly contained within that word— it may not 
cross word boundaries. 
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Explanal ion 

SUB-TABLE Specifies a SUB-TABLE declaration. 

Name A unique identifier by which the 

subtable is referenced. 

Initial Item Number of Parent Table Establishes the base item of the 

subtable by specifying the item 
number of the table at which the 4 
subtable is to start. The number 
can be either an integer or a tag 
predefined by an EQUALS statement. 

Maximum Number of Items in Subtable Either an integer or a tag that 

specifies the size of the subtable. 

Major Index Name Optional. Specifies the name of 

the major index of the subtable. 
If used, it is handled in the same 
manner as the major index of a 
table (see paragraph 4.2.2) . 

Examples 

1. SViBriTAiiHei ALftft ff { J { , , , , i i | , i i I i i i .i i I 

In this example, the subtable named BLIP starts at the initial item 
number 4 of the parent table and is 20 items long. 

2. g l « l fl-i7-,4g l i|e, ACM AMii ' Acuft* & iii i I 

The characteristics of subtable SCAN are defined by means of tags whose 
values are supplied by the EQUALS declaration. OVAL provides the initial 
item number, and ROUND, the number of items. SPOOK is the name of the 
major index. 
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4.2. 6 Like-Table (LIKE -TABLE) Declaration 

The like -table serves the same purpose for an entire table or specified number of 

items of the table as the item-area does for an item of the table. Like-tables have 

configurations identical to the tables that they duplicate. The use of like -tables 

allows the elimination of duplicate field definitions when defining multiple tables 

with identical formats. LIKE -TABLE must be enclosed within the TABLE and END- 

TABLE brackets to which the same field definitions apply. A LIKE -TABLE is valid 

in single dimension tables only. 
Format 

LIKE-TABLE name number-of-i terns major-index-name $ 
Explanation 

Specifies that a LIKE-TABLE specification follows. 
A unique identifier by which this table is referenced. 



LIKE-TABLE 
Name 
Number of Items 



Major Index Name 



Optional. An integer or tag specifying the maximum 
number of items in the table. If this parameter is 
omitted, the number of items of the like-table will be 
the same as the number of items of the parent table. 

Optional. Specifies the name of the major index of 
the like-table. This parameter, if used, is handled 
in the same manner as the major index of a table (see 
paragraph 4.2.2). 



Example 





M\T { R { K\ iVl iA4 \L\OiOi 4\ . i i i 1 i t i i i i i i i 1 


1 1 1 1 i 1 1 I 


•ii i it i i i i i iii i i i i i i i i i i i i i i 1 


I i i i i i i | 


"i i i i i i i i i i i i i i i i i i 1 i I I l i i i i i 


ii*iliKiErrr,a,i 


fiJ.fliKi -3i & i i i i -i i i i i ii ii i i ill 




£i AlfiiKi r$i i . i i i i i i i i i i i i i i i i 1.1 



In this example, I \\v I i kc-l able STRK is declared to havelhe identical 
format and field declarations as the parent table MTRK, except that it 
has only three items. 
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4.2.7 End-Table (END-TABLE) Declaration 

The END-TABLE declaration terminates the declaration of elements of the table 
identified between the TABLE and END-TABLE declarations. All the defined sub- 
components of a given table (FIELD, SUB-TABLE, LIKE-TABLE, and ITEM-AREA) must 
be defined between the table declaration and its associated END-TABLE 
declaration. 

Format 

END-TABLE table-name $ 

Explanation 

This operation terminates the declaration of elements of the table 
identified between the TABLE and END-TABLE declarations. 

Examples 

1. ifirtfl-wriAftdfi iPinci7T iA i I i i i i i i i i i I i i i i i i i i i I 

2. An example of the various table options and the resulting space allocation 
may best serve to illustrate the options. For purposes of the example, 
assume that the Compiler is generating code for a six-bit machine. One 
computer word contains bits designated through 5 as: 



5 


4 


3 


2 


1 
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The following input 



iTiAAUG . i .V, ,2i u5T \T X £S \T\fiNj)\ &\ , , , 


1 i 


II 1 


1 1 


ifl/ifiiLj),. „ I^W.i. rH 31 ,Ui .0. ,3, A i liii 


1.JL 


-Li-L 


1 1 


.PriiEiLA , , ffi ,3| ,m, ,0, ,« ^ , l , „ 


1 1 


J Li 


1 1 


i^'i^ i i |v,AiW,3| Fi ,2| ,ij ft r*i i | , j i 


J— L 


l.,LJ. 


1 1 


fi T l ff l M f 1*1*1*1*1 Fl e l*l P l 1*1 I 1 1 1 I I 1 1 1 1 1 1 1 


-U- 


1 1 1 


1 1 


hSiU^-fr.A.BiLE, iS|MrB,T|£,SfT, .% liri . i , ill 


1-L 


11 1 


1 1 


iA/iK,£r,r l M l,e, ,L,i,Kerr , .51 i i 1 .« , 


J.J.. 


,-LJ-L 


1 1 


l&Mi|-|T|A,0,L£, ,T|EjS,T, 1^1 i 1 i i l i i 1 1 1 ill 


I 1 


1 Li 


1 1 



produces the following in core: 
, 5 4 3 2 



Table 

TEST 1 Sub " 
table 

SUB- 
TEST 



I tem- 

Area 

TEMP 



Like- 
Table 
LIKET 




HP 

mm 
mm 



y/ss/j 

Weak 



Word 
Word 1 
Word 
Word 1 
Word 
Word 1 
Word 
Word 1 
Word 
Word 1 
Word 
Word 1 
Word 
Word 1 
Word 
Wora 1 
Word 
Word 1 
Word 
Word 1 

Word 
Word 1 



Item 
I tern 1 
I tern 2 
I tern 3 
Item 4 
I tern-Area 
Item 
Item 1 

Item 2 
I tern 3 
Item ...4 
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Note the following facts in conjunction with the resultant area: 

1. Table TEST is a vertical table (all words of an item are 
together) of five items of two words each. 

2. Item-area TEMP is allocated two words just like the items of 
table TEST. 

3. Like-table LIKET is allocated five items identical to the items 
of table TEST. 

4. Subtable SUBTEST exists within table TEST, occupying items 
2 and 3. 

5. Field VALUE1 ( V//A ) and VALUE 2 ( fcs^l ) are identified with 



word of every item within the table, like-table, and item- 
area. Notice the overlapping of the fields ( ) . 

6. Field VALUE3 ( HBB ) is identified with word 1 of every item 
within the table, like-table and item-area. 

7. Subtable SUBTEST does not exist within the like-table LIKET 
at the corresponding position (*) because there is no way for 
the Compiler to differentiate between the two subtables. 

4.2.8 Packing Rules 

As fields and variables are defined in data declaration statements, the 
programmer specifies various attributes of the data units. These attributes 
are used by the Compiler to determine the proper allocation of these data units 
consistent with the AN/UYK-7 memory structure and addressing scheme. When 
Compiler packing of fields is specified in a table declaration, or when 
allocation of variables is performed by the Compiler, a set of rules governs 
the manner in which the fields and variables are packed into AN/UYK-7 memory 
words . 

Three different packing algorithms are used by the Compiler: no packing, 
medium packing, and dense packing. In the descriptions of these algorithms 
that follow, the term magnitude is used to refer to the number of bits required 
to represent an arithmetic data unit (I or A type) excluding the sign bit. 
For example, a signed 32-bit integer (I 32 S) has 31 magnitude bits; an 
unsigned 32-bit integer (I 32 U) has 32 magnitude bits. 
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NOTE 

In the case of no packing or medium packing, when a 
programmer specifies the number of bits in a field 
or variable, the Compiler will guarantee a data unit 
allocation of at least that number of bits; additional 
magnitude bits may be provided. Hence, the length 
specification of an arithmetic data unit should 
always be regarded as the minimum number of bits 
required to contain that data unit. For all types 
of packing, multiword data units must always start 
in bit 31 of a word. 



4.2.8.1 No Packing (NONE) 



No packing applies only to fields in tables declared with the NONE packing 
descriptor. Such fields will be packed as follows: 



T yP e 

Boolean (B) and 
Status (S) 

Hollerith (H) 



Floating-point (F) 
Fixed-point (I or A) 



Packing 
Allocated a full-word. 

Allocated the least number of full-words required 
to contain the specified number of characters 
(four characters per word). 

Allocated two full-words. 

Allocated one full-word if the magnitude is less 
than 32 bits; allocated two full-words if the 
magnitude is less than 64 bits. 



4.2.8.2 Medium Packing (MEDIUM) 

Medium packing applies to all variables and all fields in tables declared with 
the MEDIUM packing descriptor. Medium packing is performed as follows. 
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Boolean (B) and 
Status (S) 

Hollerith (H) 



Floating-point (F) 
Fixed-point (I or A) 



Packing 
Allocated a quarter-word. 

Allocated the least number of full-words required 
to contain the specified number of characters 
(four characters per word) if greater than two 
characters; allocated a quarter-word if one 
character; allocated a half-word if two characters 

Allocated two full-words. 

Allocated a quarter-word if unsigned and less 
than nine bits in magnitude; allocated a half- 
word if less than 16 bits in magnitude; allocated 
a full word if less than 32 bits in magnitude; 
allocated two full words if less than 64 bits in 
magnitude. Illustrating these rules: an I 8 U 
receives a quarter-word; an I 7 S , I 8 S, I 15 U, 
or I 16 S receives a half-word; an I 16 U or 
I 32 S receives a full word; an I 32 U or I 64 S 
receives two words; and an I 64 U is illegal. 



4.2.8.3 Dense Packing (DENSE) 

Dense packing applies only to fields in tables which are programmer-packed, to 
tables declared with the DENSE packing descriptor, or to variables that are 
overlayed (see paragraph 4.2.9). Dense packing is performed as follows: 



llfie 
Boolean (B) 
Status (S) 



Packing 

Allocated a single bit. 

Allocated the number of bits required to hold the 
largest status constant (e.g., if seven states are 
defined, three bits would be allocated). 
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T yP e 



Packing 



Hollerith (H) 



Allocated the number of quarter-words required to 
contain the specified number of characters if 
less than five; otherwise, allocated the required 
integral number of words. 



Floating-point (F) 



Allocated two full-words. 



Fixed-point (I or A) Allocated the number of bits required to contain 

the data unit if less than 32 bits in magnitude; 
otherwise allocated two full-words. 

4.2.9 Overlay (OVERLAY) Declaration 

The OVERLAY statement allows the user to control the allocation of variables 
and fields which are to be densely packed by the Compiler. If the OVERLAY 
involves fields, the OVERLAY statement must follow the associated field 
declarations within the TABLE, END-TABLE brackets. If the OVERLAY involves 
variables, it implies dense packing, and the OVERLAY statement must follow 
the associated data declarations within the data design. 

Any number of fields or variables can be named, separated by commas, on the 
right side of an OVERLAY. All are allocated consecutive storage space in the 
order in which they are named, subject to the following restriction: a field 
or a variable defined as part of a word will be allocated so that it is 
wholly contained within a word. Compatibility in size is the programmer's 
responsibi li ty . 

Any number of OVERLAY statements are permitted and names may appear in more 
than one OVERLAY statement but logical inconsistencies must be avoided. 
Programmer confusion in using the OVERLAY statement can be avoided by inter- 
preting the word OVERLAY in this statement as meaning "overlay with." 

When using OVERLAY, the following rules apply: 



1. If the data unit name is not a field, the variable list must not 
include fields. 

2. If the data unit name is a field, all of the names in the field 
list must be fields; only fields within the same table may be 
overlayed. 
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»l. If the overlay list exceeds the size of I hi; data unit being 

overlayed, a warning message is output by the Compiler; however, 
the data allocation will still be performed. 

4. All nonfield OVERLAYS must be outside table definition brackets 
but within the data design. Field OVERLAY ' s must be within the 
table brackets. 

5. All names within an overlay must be previously defined within 
the data design. 

6. A name cannot be used more than once on the right side of an 
OVERLAY statement. 

7. If a name is to appear on the right side of one OVERLAY and to 
the left side of another OVERLAY, the statement containing the 
name on the right side must be declared first. 



Format 



data-unit-name OVERLAY variable-list or field-list $ 



Explanation 



Data Unit Name 



The name of a variable, table, field, like-table, 



item-area or subtable. 



OVERLAY 



Indicates that the variable or field list to the right 
of the operator is to overlay the data unit to the 
left of the operator. 



Variable List 



Contains the names of one or more variables, tables, 
like-tables or item-areas, separated by commas. 



Field List 



Containfs the names of one or more fields separated 
by commas. 
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Example 



i i i i i i i i i 



1 I Mill 



l I I I I 1 1 II iVlWl l^i^^l Fl i 5 ! i^l f^l I I I 1 I I I I 1 I M l 1 & 

iii i i i i i i IViRiBiU \AC\&\ ffl .5; ,a, A , | i I i n i i i l l ! I @ 



X-L 



i i . i i i Vift&itj iAiBJ> iH ,1,0, ^ i i I i i i i i i i i i 1 & 



i i I i i.i-lVifeaL : iftftfi d ,1,1. 4i i i i i ii. in ri i ® 



i i iiii 



i i i IViRgiLi 1A1AQ A A6\ \Uii$ 



II I 1 I II I II 1 il 



1A1A1C1 inn biV.S*.M.y. AflDi,, .d.B.5 A .1.111. i 



XX 



1 1 ffl 



1 1 1 i 1 1 1 1 1 1 1 1 



iiii i ii ii 



i i ii i 1 i i 



1 1 I 1 1 I I 1 ) 1 t I I I I 



$M 3 M J A y \Pj 3 |Q| y |$1 j l7] j 1 



i-L 



„ . V- 

i 1 i i ii i M;M)MjiXuiYiy3)i i I ii ii 1B1 mil 



I I II I II 1 



I I I I I i l I 1 IWi^i W|B|M jX, ft<h \U\ A \ | i l | i | | 11 1 @ 



if iWiM 'I i I kWPiMiX i ^ i ) Pi j |g| ji^ i^lM^^iAlji I . 



I I 1 I 



1 M 1 I I 1 I I 1 I I I I 1 I I I 



ijh^i^i^i^AjIft^iStjif^i i i i 



j l 



1 I M I I I I I 1 I I I I I I I l^lftkljI^lXljl/ltl^l 1 1 I I M I ifl I 1 @ 



i 1 1 1 1 1 1 1 1 fri^iBiAi^i m^Bi^Ui^i^ i/>i kWlsifi i4*i i t^i i l £ 



i i i i i i i i i lri/i£-iiii>i ifi/ixiPh iai am iSi \i\Q\ & n iiii 



i i i i i i i i l/Vi^i^l i*Wl i ft 1M1 |S| |. I i i*i iimi 




i mi ii i i i 



J>. .F.M .df, lAt { IA ,a, ,110, 



iii i i l 



1 



I I I 1 i 1 



i m l l I I 1 i 



i l l l l I I I 



IIMI 
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The results of statements 2 through 8 would be 



ACF 



ACG 



ABD 



ABE 



AAC 



Same Word 



The results of statements 9 through 11 would be: 



c 


D 


E 


F 


G 


H 


I 


J 


K 


L 


M 


N 





P 


Q 


R 


S 


T 


U 


V 


w 


X 


Y 


z 



PVRBL 



Same Word 



In the above example, a series of flags (Boolean variables) have been 
declared so that they occupy a single variable (word). This might be 
advantageous if it is frequently necessary to check to see if all flags 
are cleared. Also, since all flags are contained in a single variable, 
they can be quickly passed on procedure or function calls. Such packing 
results in more object code when data is manipulated, and care must be 
exercised in weighing the advantages gained over the resulting disadvantages. 

The results of statements 13 through 16 would be: 



INTF | FRACF 



FIXPT 
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4.2. 10 Data Referencing 

Data units are referenced in their entirety by name ( identifier) , a specific 
occurrence of an n-dimensional unit by name and subscripts, or a particular 
part of a data unit by use of a functional modifier. Variables and lists 
(tables, subtables, like-tables and i tern-areas) , when treated as entities, 
are referenced by name only. Each of these data units has its own unique 
name, as established in a declaration. Fields, items, and words are always 
referenced with their associated table, item-area, like-table, or subtable. 
Because of this, a field name by itself is never meaningful. To identify the 
subdivision of a larger data unit, the additional descriptive information is 
enclosed in parentheses after the name of the larger data unit. 

All lists are indexed (or subscripted) from through N-l, where N equals the 
number of entries. Thus, entry is the first entry in the list, entry 1 is 
the second entry, etc. 

4.2.10.1 Table Referencing 

Tables may be accessed in a variety of ways: 

a. Whole table referencing: 

1. Set every word of the given table to the specified value. 

2. Set every word of one table to the value of the corresponding 
word in another table. 

b. Item referencing - Set an item of the given table to the 
specified value(s) . 

c. Field referencing (where a word is a special case of a field 
corresponding to one word) - Set the given field to the 
specified value . 

The method of addressing may also be determined by the category into which 
the table falls : 

a. Horizontal or vertical (one-dimensional). 

b. Array (multidimensional). 
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4.2.10.1.1 Whole Table Referencing 
Format 

name 
Explanation 

Name The name of the table, subtable, or like-table. 

Examples 

(See paragraph 5.4 for rules applicable to multiword set statements.) 

1. tSitaTi iT^iBiJii iTiQ iSi » i jj 1 i . , i i i i i i I i i i i i i i t i 1 

For this example, every word of TABL1 will be set to 5. 

2. r S i £ l T l Fl*! 6 ! 1 !*! I T I°1 Tr*! 6 !**!*! 1^1 I I 1 1 I 1 I 1 I I I I I I I I I I 

In this example, every word of TABL1 will be set to the value of the 
corresponding word of TABL2. If TABL2 is longer than TABU , the 
transfer of values will stop at the end of TABL1. If TABL2 is shorter 
than TABL1, the transfer of values will stop at the end of TABL2, with 
the excess words of TABL1 unaffected. 

4.2.10.1.2 Item Referencing . There are two ways to address items, depending 
on the type of table in which the items occur: 

1. Horizontal or vertical (one-dimensional): 
Format 

named ) 
Explanation 

Name The name of the table, subtable, or like-table. 

i The item indicator. It may be a data unit, tag, constant , 

or arithmetic expression. 
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Examples 

a. iSifiT, F\A\B\l\( t \0\)\ JTfii ji] ,^| i j|| i m i I i i i I I i iiil 

All words of the first item (0) of TABU will be set to 5. 

b. iS.E.T, TnA&Lji/iViAL,), ,T,Oi 15T j t , , I . . i -»., , , . » I 

The words of the item of TABL1 indicated by the value of VAL will be 
set to 5. 

2. Array (multidimensional): 

Format 



name (d^, 



d ? ) 



Explanation 
Name 



The name of an array. 

The index corresponding to the associated dimension of the 
table. The number of indexes specified must correspond to 
the number of dimensions of the table (at least 1 but no 
more than 7). Each index may be a constant, tag, data 
unit, or arithmetic expression. 



Examples 



Column 



Column 1 



a. TABL1 



Item 


Item 


Item 1 




Item 2 


Item 2 



\S\£\T\ \T\A&L\i\(\l\*\l\)\ i7Va |4 4\ 1 i 1 1 1 n 1 1 1 11 \ \\ 1 i I 

All the words of item 1 in column 1 (the shaded area) of TABL1 
wi 11 be set to 5. 
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Column Column 1 



TABL1 



Item 




Column 1 


















Item 


Item 1 








Item 1 










Item 2 








'/////// 

V'ltem 2 // 

///////a 


Level 








Level 1 



\S\£\7\ \TAfi£-i*IS&'iti'iti)i MA \S vt\ i i i 1 i I t i i i i i i i i 1 



All the words of item 2 in column 1 of level 1 (the shaded area) 
of TABL1 will be set to 5. 



4.2.10.1.3 Field Referencing . There are two ways in which fields may be 
addressed, depending on the type of table in which the fields occur: 

1. Horizontal or vertical (one-dimensional): 
Format 

name(i.f) 
Explanation 

Name The name of the table, subtable, or like-table, 

i The item indicator. It may be a data unit, constant, 

tag or arithmetic expression. 

f The field indicator. To specify a field previously 

defined within the table, f must be the field name. A 
word is a special type of field which may be indicated 
by a constant, data unit, tag, or arithmetic expression. 



I I -4-47 



M-5035 



Examples 

a. iSiEiTi t ^[fi\^L(\^\y F i L i^)\ \ r iO\ 1*1 1^1 i i 1 i i i i i I i i t 1 

The predefined field FLD of item 2 of TABL1 will be set to 5. 

b. iSlElfi iTI/liSlL^^,!!), 1 li7 1 l$l I I 1 I I I I I I 1 1 I I I 1 

Word 1 of item 2 of TABU will be set to 5. 

2. Array (multidimensional): 

Format 

name(d, , . . . , d ,f ) 
1 n 

Explanation 

Name The name of the table. 

dj The index corresponding to the associated dimension of 

the table, as previously described. 

f The field indicator. To specify a field previously 

defined within the table, f must be the field name. A 
word is a special case of field that may be indicated by 
a constant, data unit, tag or arithmetic expression. 

Examples 

The contents of BUFLAG will be placed in the field FLAG of item 2 in 
column 1 of level 1 of TABL1. 

|Tjfr| {S[ t^l i i 1 i i i i i M i i 1 

Word 1 of item 1 of column will be set to 5. 
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c. 



SET. , KA3\(MrABM&M ^ iy fiL<h)\ iT|Q| ,0, i$i i i I 

The contents of field FLD of the item represented by the expression 
2*TAB1(I,FLD1) will be set to 0. 



d. iTIrtigilii 



i.i 1.1 1 i I I I 
J (jit) I 111.) I 



Ul 



iTi^,6iL|i r 

| T | ^ | fl|^ ((l ij i6S 



I 1.1 1 



* » « » » I ■ % I ' J * 1 * ' ^ ' ' "t 

iTifli&liifpfrJil.ji JA , 



1 i I i I I I ) i i Whole table. 



I I I I I I I I I Item 4 - 



I I I I I I I I I Field FLD of Item 4. 



..... | Word 2 of item specified 
1 1111 1 111 by IND1. 
I I I I I I I I I Field FLD of item in 



Word Specif ied by TAG1 of 



of item specified by 
IND1 of column specified 
by IND2 of level speci- 
fied by IND3. 



NOTE 

The interpretation of the referencing is governed 
by the structure declared in the TABLE declarative. 



4.2.10.1.4 Item-Area Referencing . An item-area is addressed by its name. 
The name alone addresses the total item. A field specification may be 
included to address a field or word. 

Format 



name 



or 



name (f) 
Explanation 
Name 
f 



The name of an item-area. 

The field indicator. To specify a field previously 
defined within the parent table, f must be the field 
name. A word is a special case of field that may be 
indicated by a constant, data unit, tag, or arithmetic 
expression, f 
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Examples 

1. iSiEj'Ti m r \£iW\ \ i i m M 1 1 i m 1 1 m 1 1 1 i i 1 1 

Every word of ITEMA will be set to 5. 

2. g»gTi y.r.g^.OFi^. TA , , , , , , 1 , , i i , , , , i I 

Field FLD of ITEMA will be set to 5. 

3. hS|E|*H CTEMl^l(i^()i i Jfix i Pi i 1 I i I I i 1 I I i 1 i i I i i I 

Word 2 of ITEMA will be set to 0. 
4.2.11 Transfer Declaratives (Switches) 

The transfer declaratives allow the establishment of switches for determining 
indirect linkage within procedures and for transferring control from one 
procedure to another. There are two classes of transfer declaratives: 
statement switches and procedure switches. 

4.2.11.1 Statement Switch (SWITCH) Declaratives 

The statement switch is a collection of statement labels to which control may 
be transferred, depending on various conditions encountered during processing. 
For purposes of identification and selection, the switch is a unit identified 
by a switch name. Since statement switches are collections of statement 
labels, and since statement labels are always local to the system procedure 
in which they are defined, switch declarations must fall within local data 
design (LOC-DD) brackets. There are two types of statement switches: index 
and item. 

4.2.11.1.1 Index Switch . The index switch defines a transfer of control 
that is determined by a user-supplied index. 
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Format 

SWITCH name switch-point, switch-point, , switch-point $ 

Explanation 

SWITCH Specifies the beginning of a switch definition. 

Name An identifier used to reference the switch. 

Switch Points One or more statement names separated by commas. 

The switch points of a given switch are accessed by use of an index (see 
paragraph 5.5). The value of this index is within the range through 
n-1, where corresponds to the first switch point and n is the number 
of switch points. 

The program must include validity checking of the index if there is a 
possibility of the index having a value outside the switch range. 

Example 

iSlMllTigltf, , Ifl.ftXl &>Ly \SA\y .S,3y ,5.4 l^l I I I I I I I I I I i 

This declaration defines switch BPX with switch points SI, S2, S3, and 
S4. A reference to switch BPX transfers program control to one of four 
statements labeled Si, S2, S3, or S4 depending upon a numerical input of 
0,1, 2, or 3, respectively. 

Two switches may be defined simultaneously by specifying two names for each 
switch point. In declaring these switches, a separate statement is required 
for each pair of switch points. The list of switch-point statements is 
delimited by an END-SWITCH declaration. The second switch name and associated 
switch points may be omitted and the result used as an alternate form for 
defining a single index switch. 
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Format 



SWITCH name-a, name-b $ 

switch-point .switch-point $ 



switch-point , switch-point $ 
END -SWITCH name-a, name-b $ 



Explanation 

SWITCH 

Name-a 

Name-b 

Switch Point 
END -SWITCH 



Specifies the beginning of a switch definition. 

An identifier used to reference the left column of 
switch points. 

Optional. An identifier used to reference the right 
column of switch points. 

A statement name. 

Specifies termination of the switch definition. 



In referring to the switch with name-a, the index specifies one of the 

switch points in the left column. Switch points in the right column 

are selected by use of name-b and an index. The program must include 

* 

validity checking of the index if there is a possibility of an index 
outside the range through n-1. 



Examples 



i6M / 1 T\C\H\ I \F\L\I lfl f I iflLlOiPl # 



1 1 1 I 1 1 1 1 I I 1 1 1 1 1 1 1 I 



1 I 1 I 



1 | ■\\i'\TP &ftL\E \ } \ \ *\ °\ L 7'\ i*i l I I I I 1 i 



i i i I i i , I frifi*iCiaift,y, 5 i islu/icifr, i*i i i i i 1 i i i i i i i i i 



i i i i i n i l£^i}»in6iwiiiriq^l iF|t|/i^i iF\L\o\P\.Ai \ i i i i 



In this example, the SWITCH declaration generates two independent 
switches, FLIP and FLOP. A reference to switch FLOP will transfer 
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program control lo the statement BOLT or the statement SWCH, depending 
upon a numerical input of or 1, respectively. 

The number of switch points in the left-hand column may be greater than 
the number in the right-hand column. In this case, only one statement 
name is specified. 

2. fi \ » \ i\rf> \ H\ | I sh^l i St* A £ 1 1 I l I I 1 1 I I 1 1 I It 1 I 



1 I 1 I I 1 I 



i i i i 1 i i i i i i 



i i i i i i i 



i. i i i l i i I i i i i i i 



i i i i i i i i 



i i i i i i i I i i i i i i 



Ml 1 Mil, 



_L_L 



? 



1 I I I I 1 I 1 I I I I I I 



J_L 



1 I 1 1 I I I 



Switch SWl may be referenced by index values of 0, 1, 2 and 3. 
Switch SW2 may use index values of 0, 1 or 2. 

4.2.11.1.2 Item Switch . The item switch defines switch points that are 
accessed by a constant as specified in the definition. The Compiler performs 
a compare between the value of the variable name contained in the switch 
statement and the constants of the definition. Control will then be trans- 
ferred to the switch point that corresponds to the matching constant. 
Validity checking of the data unit name is not necessary as program control 
will continue with the next instruction if a match is not found. This means, 
however, that the instruction sequence following must be applicable to a not- 
found condition. The variable specified in the item switch declaration must 
be defined prior to its reference in the switch declaration and must not 
exceed two words in length. 
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Format 



SWITCH name (variable-name) $ 
constant, switch-point $ 



constant , 
END-SWITCH 

Explanation 

SWITCH 

Name 

Variable Name 

Constant 

Switch Point 

END-SWITCH 

Example 



switch-point $ 
name $ 



Specifies the beginning of a switch definition. 

An identifier used to reference the switch. 

The name of a variable whose value is to be compared 
against the list of constants in the left-hand column. 

A CMS-2 constant of two words or less in length. This 
constant must agree in type with the variable. 

A statement name. 

Specifies the termination of the switch. 



jSiKimqHi | byiDlRFl \(\T\l\i'\\\$\fil)\ \*\ 1 I I 



l 1 1 i l l I I l 



■Mi (iSiTie, pSi^|n^r,CiOiMA - i» 



i_L 



L_L_L 



i I » I » I I I ' l I l ' 1 i \ i i 



»l I 1 



I I I I I I I I I I I I I I I I I 



■ ■ ' ■ ' ' ' 



i i i i i i i i i 



This declaration defines switch SWOFF with switch points ELEMENT , UNCOND, 
and DONE. A reference to switch SWOFF will transfer control to one of 
these switch points, depending upon the value of the variable named 
FINISH. If FINISH is equal to H(TERM) , control will transfer to the 
statement DONE. 
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4.2.11.2 Procedure Switch (P-SWITCH) Declaratives 

The P-SWITCH is a collection of procedure names to which a call may be made, 
depending on conditions encountered during execution. The list of procedure 
names identifies the procedures accessible by the switch., Procedure switches 
are declarations, and can fall within the data design brackets (SYS-DD or 
LOC-DD) or may stand alone (i.e., within a SYS-PROC but outside a LOC-DD or 
procedure). There are three types of P-SWITCHes: index procedure, double 
procedure, and item procedure. 

4.2.11.2.1 Index Procedure Switch 
Format 

P-SWITCH name INPUT formal-parameters OUTPUT 
formal-parameters $ 
switch-point $ 



switch-point $ 
END-SWITC0 name $ 



Explanation 
P-SWITCH 
Name 
INPUT 

OUTPUT 

Formal Parameters 



Specifies the P-SWITCH declaration. 

The identifier by which the p-switch is referenced. 

Optional. Specifies that formal input parameters 
for each p-switch procedure follow. 

Optional. Specifies that formal output parameters 
for each p-switch procedure follow. 

A list of names (single identifiers) , separated by 
commas, which are to be input or output to the 
procedures. 
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Switch Point 



END-SWITCH 



The name of a procedure accessible by the switch. The 
switch points are indexed by a value within the range 
through n-1, where corresponds to the first switch 
and n equals number of switch points. The program must 
include validity checking of the index if it can exceed 
the range through n-1 (see paragraph 5.5) . 

Specifies the termination of the switch. 



This declaration allows the use of input and output parameter transfers. 
If formal parameters are specified, they must be identical for every 
procedure of the p-switch. No abnormal exits are allowed. Transfer to 
the procedures specified is activated by a procedure-switch linking 
statement (see paragraph 5.3). 

Example 



i i i i i i i i 



i i i i 



1 * i i i i i i i I i i i i i i i i i 



i i i i i 



i i^i i i 



i i i i i i ii 



i ii i i i hi 



i i i i i i i i I i 



| 7fr)ATi* 



i i i i 



i i iii ii i I i i i ii ii i 



i i i 



i i i i i i i i 



I I I I I I I I I 



III 



This declaration defines procedure switch TRIG whose input parameters are 
ANG and SIDE and whose output parameter is SOL. A reference to switch 
TRIG transfers control to one of the procedures SIN, COS or TAN, depending 
upon a numeral index of 0, 1 or 2, respectively. 

4.2.11.2.2 Double Procedure Switch . Two procedure switches may be defined 
in a single declaration. 
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Format 



P-SWITCH name-a, name-b $ 

switch-point, switch-point $ 



switch-point, switch-point $ 
END-SWITCH name-a, name-b $ 



Explanation 

P-SWITCH 

Name 



END-SWITCH 



Specifies a P-SWITCH declaration. 

The name of a procedure. A switch point is indexed 
by a value within the range of through n-1 where 
n is the number of switch points. 

Specifies the termination of the switch. 



Multiple procedure switch declarations do not allow formal input or 
output parameters. Name-b and associated switch points define a second 
procedure switch. 



Example 



i i lTifl<Vi*i 1V1 i I i i i i i 



LLi 



I 1 i f I II 1 I 1 I I I 



1_JL 



I 1 1 I I 



1_L 



i i i i i i i i i I i i i i i 



This declaration defines independent procedure switches PLANE and TRAIN. 
A reference to switch PLANE will transfer program control to one of the 
procedures AIR, PROP or FOG depending upon a numerical input of 0, 1 or 2, 
respectively. 
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4.2.11.2.3 Item Procedure Switch 
Format 

P-SWITCH name (variable-name) INPUT formal-parameters 
OUTPUT formal-parameters $ 
constant, procedure-name $ 



constant, procedure-name $ 
END -SWITCH name $ 



Explanation 

P-SWITCH 

Name 

Variable Name 



INPUT 



OUTPUT 



Formal Parameters 



Constant 



Procedure Name 



END-SWITCH 



Specifies a P-SWITCH declaration. 

An identifier used to reference the P-SWITCH. 

The name of a variable whose value is to be 
compared against the list of constants in the 
left-hand column. When a match is found, the 
procedure that is paired with the constant will 
be accessed. 

Optional. Specifies that the names which follow 
are the formal input parameters. 

Optional. Specifies that the names which follow 
are the formal output parameters. 

A list of the formal names, separated by commas, 
of the input and output parameters. 

Any allowable CMS-2 constant of two words or 
less. This constant must agree in type with 
the variable. 

Identifies the procedures accessible by the 
swi ten . 

Specifies the termination of the list of procedure 
names . 
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Example 



i_i 



1 1 I 1 1 I I I I I 1 I 1 I 1 



I 1 I I I 1 1 I I I I 



1 I I 



U_ 
II 



1 1 1 1 1 I 1 11 11 



1 1 1 



1_L 



| | (1^^1) 1 Vi^T|P|C , i » | 
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I I I 



1 1 1 I 
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I I I 



A procedure switch linking statement would invoke the procedure item 
switch. This would cause the contents of the variable MTYPE to be 
compared against the list of constants in the LINK procedure switch 
table. A match generates a procedure call to the procedure associated 
with the constant. The formal parameters are ADDR and RESLT. 

4.2.11.3 Switch Referencing 

Statement switches (index and item) are referenced by a GOTO statement. 
Paragraph 5.5 provides examples of such referencing. Procedure switches 
(P-SWITCH) are referenced by a procedure switch call. Paragraph 5.3 provides 
examples of such referencing. 



4.2.12 Local Indexes 

Identifiers may be used to refer to machine index registers within the range 
of a procedure by means of index declaration statements. Two types of 
indexes may be declared: system indexes and local indexes. 

System indexes are global identifiers that must be declared in a major deader 
(see Section 7) . 

Local indexes are declared for use within a procedure by means of the LOC- 
INDEX statement. 
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Format 

LOC-INDEX name(s) $ 
Explanation 

LOC-INDEX Indicates that the following name or names are to 

refer to the Compiler-assigned index register(s) . 

Name An identif ier(s) of the index register(s) . It must 

not be previously defined in a data declaration. This 
name can be an actual (not a formal) parameter in a 
procedure call. Multiple names are separated by 
commas . 

The declaration should immediately follow the PROCEDURE statement. 
Examples 

iLacn/iAtMIXi iMfiMrfi i ^ , , i i i i m i I i i i i i i i i i I 
^PiCn/i^ielx, $Am*y U*A A , I i i i i , . . . i I 

The following conventions apply to declaration and use of indexes : 

1. Two index registers (B6 and B7) are reserved for Compiler use and will 
never be assigned to a user-declared index. 

2. Five index registers (Bl through B5) may be assigned specific data names 
by SYS-INDEX statements. 

3. Up to five index registers may be assigned by the Compiler for use in a 
procedure by LOC-INDEX statements. 

4. The sum of the number of index registers assigned by LOC-INDEX and 
SYS-INDEX statements will never exceed five. 

5. There is no restriction on the number of local indexes which may be 
defined by LOC-INDEX statements. However, if index registers are not 
available, temporary locations in memory will be assigned. 

6. In non-arithmetic operations the Compiler manipulates index registers as 
16-bit, unsigned, integer data units. When index registers are used as 
operands in arithmetic expressions, AN/UYK-7 sign bit considerations 
require that the result of the expression must not exceed 15 bits in magnitude. 
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4.2.13 Data (DATA) Declaration 

A DATA declaration may be used to assign a preset value to a previously defined 
data unit. EQUALS tags may be used to represent numeric constants (see Section 
7). 

NOTE 

The DATA declaration is accepted by the AN/UYK-7 CMS-2 
Compiler to provide additional compatibility with other 
CMS-2 compilers. However, its implementation is not 
fully compatible with other CMS-2 language implementations; 
nor can its continued existence in this or future CMS-2 
implementations be assured. It is strongly recommended 
that the variable and field preset capability and the 
extensive direct code preset features available with 
this compiler be used in place of the DATA declaration. 
Each DATA declaration generates full word preset values; 
no partial word variables should be preset via the DATA 
declaration. 



Format 

name DATA 
Explanation 
Name 



Constant-a 



Constant-b 



constant-a constant-b $ 



An identifier of a table, subtable, variable, liketable, or 
item-area. After the first declaration, name is optional when 
presetting sequential words of a multiword data unit. When 
presetting these units, a user must be aware of the word allo- 
cation format (see Example 2 on the following page) . 

A numeric integer constant, Hollerith constant, or tag assigned 
as an initial value for the named data unit. If name identifies 
a variable, the type of this constant must agree with the type 
of the variable. 

Optional. A numeric integer constant or tag that is used when 
a dual preset value may be applied to a data unit. When con- 
stant-b is specified, constant-a assigns a value to the upper 
ha If word of the data unit and constant-b assigns a value to the 
lower ha If word of the named data unit. Constant-b is not allow- 
ed when constant-a is Hollerith. 
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A numeric constant may be followed by a scaling specifier (a comma followed by 
a positive integer constant). The scaling specifier must be given if the pre- 
set value is to have any fractional precision. 

Examples 

1. \T\AC\ i 1 7 171 ii i i i I 1 i i i i I I I I I 1 l i I l I I I I I I 

The whole word, referenced by the data unit name TAC, has an initial 
preset value of 77. 

2. One DATA declaration per data unit name presets only the first word of 
the unit. To preset several or all words, the following format is 
employed, using table DICT as an example: 



i&ZiflTT i \DdT\A ^1 i I l I i I i 



i I M i i i £Wl7 V a | 7 I \ \ \ t 



I i I i i I I I I 1 l I I I I I I I I 



i Mil I i £>d\TA i/i/i i i4i 1 1 i i i i I i I I I I i I I I I I I I I 



The first word of table DICT has an initial value of -64. The second 
word has an initial value of 7 in the upper half and in the lower half. 
The third word has an initial preset value of 11. When using this method 
of table presetting, the user must be concerned with word allocation 
format so that a data reference will give the proper preset value. 

3. i \H0J-Y\& i udflrtfl \H\(\ T \ V/ iQ\Yhb&\)\ \t\ l I I I I I I I I I I I I I 1 

This declaration will preset the Hollerith variable HOLVB with the char- 
acters TWOWDS (left-adjusted with two trailing blanks) . 

4.3 CONTROL DECLARATIVES 

A variety of declaratives are available for use in specifying various Compiler 
control information. Most of these declarations control allocation or code 
generation on an element-wide basis. They appear primarily in major or minor 
headers, and are therefore described in Section 7. The MODE declaration is 
closely related to the data declaration process and is therefore described 
in the following sections. 
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4.3.1 Mode (MODE) Declaration 

The MODE declaration defines the format of variables and fields for which no 
attributes are declared. A MODE declaration may appear within headers or data 
designs; it overrides the Compiler-inherent mode. When a mode declaration appears 
in a major header, it remains in effect throughout the system compile. When it 
appears in a minor header or within a data design, it remains in effect throughout 
that element or until another MODE declaration is encountered. In conjunction with 
the MODEVRBL option (see Section 7), the MODE VRBL declaration is also permitted 
within procedures and functions. 
Format 

MODE VRBL description $ 
MODE FIELD description $ 

Explanation 

MODE Specifies the MODE declaration. 

VRBL A variable MODE declaration. 

FIELD A field MODE declaration. 

Description The format as specified in VRBL or FIELD declarations 

(see paragraphs 4.2.1 and 4.2.3). Specifying an initial- 
value is allowable in a variable MODE declaration. 

Examples 

i. , mx>M> , ■ ly.fifti, a, M % J3> 4, , ■ , I I 

If the example were included in a data design, all succeeding variables 
within the data design that contain no attribute specification would 
adhere to the format A 24 U 13 until the next variable MODE is 
encountered. All variables would be fixed-point with a length of 24 
bits and unsigned, with 13 fractional bit positions to the right of the 
binary point. 
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In this example, fields XI, Yl and Tl have undeclared data-type attributes; 
therefore, the MODE-declared attributes of A 32 S 16 would be assigned 
to each. Note that it is still necessary to specify the word location 
and starting bit for those three fields since Compiler packing was not 
specified. 

4.4 SYSTEM LINKAGE 

System linking is the process by which program information known to one basic 
CMS-2 element may be communicated to another basic element. It may be 
required when the information is local to a system procedure within a SYSTEM 
or unknown because the elements were compiled under different SYSTEM headers. 
The following items may be linked between two basic elements: 

a. Tables (and associated items) . 

b. Variables . 

c . F-swi tches . 

d . Procedures . 

e. Functions. 

f . Fi les . 

( 
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The capability to link the above items between and within basic CMS-2 elements is pro- 
vided by the EXTREF, EXTDEF, TRANSREF, or LOCREF operators. This capability 
eliminates the need to expand the local concept of certain items and/or include entire 
elements within SYSTEM compiles when only a few unknown items are referenced. 

Because segments containing items a through f can be linked at load time, it is 
unnecessary to externally reference a procedure (unless it has input/output parameters 
or exits) or to define a procedure in a segment in order to call it in that segment. 
Although the compiler will not flag such an "undefined" procedure, the loader will do 
so if that procedure remains undefined at load time. 

4.4.1 External Definition (EXTDEF) Operator 

The name and associated declaration following the operator EXTDEF is to be 
considered as global so that it may be referenced within any basic element 
of any SYSTEM compilation. 

Format 

(EXTDEF) identifier-identification $ 
Explanation 

EXTDEF. Specifies an external definition. 

Identifier-Identification A symbol and its associated definition defined 

totally within this SYS-PROC. 

Examples 

i. i |Viftg|ii 1*1 if? rti 1 1 1 i M 1 1 1 1 1 1 1 1 1 1 1 n 1 

This example specifies that VRBL X, defined in a LOC-DD of the SYS-PROC, 
is referenced by other SYS-PROC's and is to be considered global. 

This example declares that variables XX, YY, and ZZ within this SYS-PROC 
are global floating-point data units. 
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4.4.2 External Reference (EXTREF) Operator 

The declaration following the operator EXTREF defines an item that is 
physically located in another SYS-PROC or SYS-DD and is referenced within 
the current SYS-PROC. Allocation of the item will not occur in the SYS-PROC 
being compiled, but the definition to provide the necessary element compati- 
bility will be applied. 

Format 

(EXTREF) identifier-identification $ 
Explanation 

EXTREF Specifies an external reference. 

Identifier-Identification A symbol and its associated identification 

that is referenced from, but not located with 
this SYS-PROC. 

Example 

i (i f i x iTi^^i)i Iv'ifriSilj \F\U I ill r*i i i i i i i i i i i i ii M i i 1 

This example specifies that VRBL Fl is used within this SYS-PROC, but is 
physically located in another SYS-PROC or SYS-DD. 

4.4.3 Transient Reference (TRANSREF) Operator 

The declaration following the operator TRANSREF defines an item that is 
physically located in another SYS-PROC or SYS-DD that cannot be assigned a 
permanent base register. References made to this item will result in the load 
of a transient base register to cover the referenced SYS-PROC or SYS-DD. The 
definition furnished will be applied to provide the necessary element compati- 
bility. 



Format 



(TRANSREF) identifier-identification $ 
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Explanation 
TRANSREF 

Identifier -Identific ation 



Specifies a transient reference. 
A symbol and its associated identification 
that is referenced from, but not located 
within, this SYS-PROC. 



Examples 



iiii 



I l l 1 l l l I I 1 l I I 1 



l I I I 1 1 I 1 



4.4.4 Local Definition (LOCREF) Operator 

The procedure or function declaration following the operator LOCREF is considered 
local to the system procedure in which it is contained, so that forward references to the 
procedure or function receive proper parameter linkage. The declaration containing 
the (LOCREF) modifier must appear in a local data design prior to the procedure or 
function containing the local forward reference. Formal parameters must be defined 
prior to the declaration. 

Format 

(LOCREF) procedure or function declaration $ 
Explanation 

Specifies a local procedure or function declaration. 



LOCREF 



Example 

i \M \M\ W\ ff\h ft »>i i u » t*< 



lit! 



I 1 If I 111 1 1 I 



i i i ,i. 



, U \acmF^ iP.fi.ac.&Dita.F, .P,r,ai ■r.AJ.p.u.T, ,v,ftiii 



I I 1.1 I l. 



This example specifies that procedure PRA is a procedure local to the system 
procedure and is called locally within this system procedure. Its formal input 
is VB1. 
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4.4.5 Applications of EXTDEF, EXTREF, and TRANSREF 

i. i A i i i i i i i ftjV^nfftQ^i ifl i i i i t i i i i I i i i i i i i i i I 

I ,1 I I I I I I I l^ft^jfrftl 1^1 I I 1 1 1 I I I I 1 I 1 I 111 1 Mill 

i i 1 i ii i i i i i i 1 
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m mi 



I l I I I I l i I I I I i i I 



i i i I l I i i I 



lX|Ti£|Ajri/»i^£iAl l5^i/HiBi ifr i i i I i i I I I I I i i I 



l ill I I I I I 
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I I I I I I I I I 


I I M I I I I I l I I I l I I M l I I I I I I I I 


ift II I I I I I 


SiViSnPi^^ ! i$ i i i i ii I m in hi ii i I 


I.I II I II LI 
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I W<* Wi 
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. ii. i i . i i ]Pii.giL»i> ,s,Mj| ,/>, ,S. rt. II. Juli i^i i i i I 



I 1 1 1 I I i i i -■. l MhMm T i M*» i g l foU^Lj -fi 



i 1 1 1 1 1 1 1 1 



I II I II I I I i M I I 



im mil IXiri£^i>i/liR|C|/9i ISi^if HiSi iA i i i I i I I I I I I I 1 



I I I I II M I 



I I I 1 I I I I I II I I 



Table SUM is linked between system procedure A and system procedure B. Since the 
field defintion for SUM1 is included in the table description, SUM1 is also linked be- 
tween A and B. A reference to SUM (0, SUM1) in either system procedure will access 
the same data unit. 

Subunits of tables, such as like-tables, subtables, and item-areas are not automati- 
cally linked between system procedures. In this example, a reference to SUMB will 
access different data units. However, linkage can be achieved for subunits of tables. 
Item -area SUMA is externally defined in system procedure A and externally referenced 
in system procedure B, thus providing the ability to reference the same data unit from 
either system procedure. 

An externally referenced table must have the same field definitions as that of the ex- 
ternally defined table. Only like -tables, subtables and item -areas may be added or 
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deleted from the definition. As an example of this, SUML can be included in system 
procedure B without being in system procedure A as long as it has the same attributes 
as table SUM. 
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Procedure ALPHA is in SYS-PROC HAND. SYS-PROC BETA initiates a procedure 
call to ALPHA by means of ALPHA INPUT Al OUTPUT A2$ . To indicate this 
cross-referencing to the Compiler, procedure ALPHA and its associated 
formal parameters, variables PI and P2, are flagged as external references 
in SYS-PROC QpTA and as external definitions in SYS-PROC HAND. 
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Vthvn SYSTEM A was compiled, the programmer anticipated using two variables 
from different SYS-IJUVs in SYSTOl H that would not be covered under the 
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same base register. This capability allows assigning a base 
register to one SYS-DD when SYSTEM A is loaded for execution and a 
transient register to the other SYS-DD. It was not necessary to 
attach the operator EXTDEF to the variables in SYSTEM B since 
they are within SYS-DD* s and, hence, global. 

Use of the TRANSREF and EXTREF operators allows the Compiler to 
generate the appropriate object code for SYSTEM A. The allocation 
is determined by the system Loader. 

4. SPCX SYS-PROC $ 
LOC-DD $ 

VRBL VX1 A 16 S 10 $ 
(LOCREF) PROCEDURE PRX1 OUTPUT VX1 $ 

VRBL VX2 H 2 $ 
(LOCREF) FUNCTION FNX.2 (VX2) H 4 $ 

VRBL (VA3,VA4) A 32 S 24 $ 

VRBL (HA 5 ,HA6) H 4 $ 

END-LOC-DD $ 
PROCEDURE PRCA1 $ 

PRX1 OUTPUT VA3 $ 
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SET HA5 TO FNX2(HA6) $ 

END-PROC PRCA1 $ 

PROCEDURE PRX1 OUTPUT VX1 $ 

END-PROC PRX1 $ 

FUNCTION FNX2 (VX2) H 4 $ 

END-FUNCTION FNX2 $ 
■ • 

END-SYS-PROC SPCX $ 

Procedure PRX1 and function FNX2 are local to system procedure 
SPCX; both are called prior to their definition by procedure 
PRCA1. Including the declarations in the local data design prior 
to PRCA1 permits more accurate error checking and generation for 
their parameter passage with respect to scaling and type. 



II-4-72 



M-5035 
Change 4 

SECTION 5 
DYNAMIC STATEMENTS 

Dynamic statements specify processing operations within procedures and 
functions. They perform calculations, manipulate data, and direct control of 
the program. 

This type of statement consists of an operator followed by a list of operands 
and additional operators. An operand may be a single name, a constant, a data 
unit reference or an expression. Expressions may be arithmetic, Boolean, 
relational, or literal. 

Dynamic statements have two possible forms : simple and compound. A simple 
statement comprises a single dynamic statement followed by its statement 
terminator ($). A compound statement consists of two or more dynamic 
statements, each separated by the connector THEN, followed by a single 
$ statement terminator. 

With the exception of decision statements (Paragraph 5. 6), there are no 
restrictions on the number or types of dynamic statements which may be 
compounded. With this exception, the connector THEN is exactly equivalent to 
the terminator $. 

Example 

The compound statement 

SET A TO B THEN PROCA INPUT X 
THEN L2. SET E TO F THEN GOTO LI $ 

is equivalent to the simple statements: 

SET A TO B $ PROCA INPUT X 
$L2. SET E TO F $ GOTO LI $ 
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Simple and compound statements may also be grouped into a statement block by 
the formation of a BEGIN, VARY, or FOR block (Paragraph 5.7). Statement 
blocks are required in order to nest decision statements (Paragraph 5. 6. 6). 

5.1 EXPRESSIONS 

The arithmetic, Boolean, relational, and literal expressions used in dynamic 
statements are described in the following paragraphs. 

NOTE 

Variables, constants, local and system indexes, field 
references, typed item references, item word references, 
function references, and functionally modified data 
units may be used as operands in CMS -2 expressions. 
Tables, sub-tables, like-tables, and untyped item 
references may not be used as expression operands. 

5.1.1 Arithmetic Expressions 

An arithmetic expression consists of two or more arithmetic data units or 
constants (operands) connected by arithmetic operators. The operators and 
their hierarchy of execution are defined in Table 5-1. Operations involving 
the level-1 operators are evaluated first, followed by evaluation of operators 
of levels 2 and 3. 
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TABLE 5-1. ARITHMETIC OPERATORS 



nlLKAntni Ur 






EXECUTION 


OPERATOR 


FUNCTION 


1 




Unary minus 


1 




Exponentiation 


2 




Multiplication 


2 


/ 


Division 


3 


+ 


Addition 


3 




Subtraction 



If expressions involve more than one operator of the same hierarchy, execution 
is performed from left to right in the order in which the operators are 
encountered. For example, A*B/C is evaluated as (A*B)/C. The one exception 
to this rule occurs with expressions involving the exponentiation and unary 
minus operators (level-1). In this case, execution proceeds from right to 
left. For example, -X**-Y is equivalent to -(X**(-Y)), unless X is a 
constant in which case the Sign is part of the constant. Note that the unary 
minus is the only operator that may directly follow another operator. 

Example 

A+B*C/D**3 is evaluated in four steps: 

1. B*C 

2. D**3 

3. The result of Step 1 divided by the result of Step 2. 

4. A plus the result of Step 3. 

When operations are specified by parentheses, those within the innermost 
parentheses are performed first. 

Example 

D*((A+B)**C) is evaluated in three steps: 

1. A+B 

2. The result of Step 1 raised to the power of C. 

3. D multiplied by the result of Step 2. 
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Arithmetic operations are performed in one of two modes: floating-point or 
fixed-point. Floating- and fixed-point data units may be mixed within an 
expression. However, an operation is performed in fixed-point mode only if 
both operands are fixed-point. Exponentiation involving a scaled exponent is 
performed in floating-point mode. 

The radix point of a fixed-point operand is determined by a data declaration 
or by an in-line definition. Using an in-line definition, the radix point is 
specified following the operand with the scaling specifier (..). An in-line 
definition overrides a data-declaration definition. 

Example 

A..5+B..7 

In this example, A has a radix point of 5 and B' has a radix point of 7. 

Only an integer constant, an EQUALS tag, or a name defined in a MEANS 
declaration may follow the scaling specifier. An in-line definition is valid 
only for a particular reference. Any succeeding operand reference utilizes 
the radix point definition of the data declaration unless the radix point is 
again defined in-line. 

Precision of fixed-point arithmetic operations is dependent upon the function 
of the statements. ' 

5. 1. 1. 1 Fractional Significance in Fixed-Point Operations 

The rules for determining fractional significance in operations between two fixed-point 
operands A and B are described below. Aij. operand may be a data unit, a constant 
or the result of a subexpression. The radix point of a data unit is the number of 
fractional bits defined in the data declaration or the in-line defined scaling specifier. 
The radix point of a mixed or fractional constant equals: 

1. 3. 2 *n+l truncated to an integer, if constant is decimal, or 

2. 3*n, if constant is octal 

where n is the number of fractional digits. The radix point of an intermediate result 
or subexpression is determined by application of the scaling rules. 
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In the discussion of scaling rules, the following abbreviations are used: 



Abbreviation Meaning 
x Radix point of A. 

y Radix point of B. 

z Radix point of receptacle in a replacement 

statement, or radix point of simulated 
receptacle in relational expression or 
programmer supplied override value. 

min(x,y) The smaller value of x and y. 



For relational expressions, FOR-expressions, or replacement statements with floating-point 
receptacles, the following are applied to determine the radix point of the simulated receptacle. 

1. If x and y ^ 0, then z = min(x,y). 

2. If x = andy = 0, then z = 0. 

3. If neither of the above is true, then z equals the nonzero scale factor (x or y, 
whichever is nonzero). 

The programmer may override the Compiler determined value of z by enclosing an 
expression within parenthesis followed by the scaling specifier (. . ) and then specifying the 
desired value of z. 

Example 

(A+B/C+D). .5 

This specifies that each operation within the parentheses will be performed in 
accordance with the scaling rules for fixed-point arithmetic with "z" equal to 5. 

The scaling rules for fixed-point arithmetic are now described as follows: 

1. Addition and Subtraction (A+B) 

a. Ifx =y, the radix point of the result is x. 

b. If min(x,y) is greater than z, the radix point of the result is min(x,y). 

c. If neither rule a nor rule b is true, the radix point of the result is z. 
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2. Multiplication (A*B) 

a. No alignment prior to multiplication in relational expressions. 

b. If x is greater than z, and A is the result of a previous multiplication, 
operand A is aligned to z prior to the multiplication. If y is greater 
than z, and B is the result of a previous multiplication, operand B is 
aligned to z prior to the multiplication. 

c. The radix point of the result (product) is the sum of the radix points of 
the operands after application of rule a or rule b. 

3. Division (A/B) 

a. If y is greater than z, then B is aligned to z prior to the division. 

b. A is aligned to y + z so that the result (quotient) will have scaling 
equivalent to z. 

4. Absolute value and complementation 

a. There is no adjustment of scale factors; i. e. , the scaling of the result 
equals the scaling of the operand. 

5. Exponentiation 

a. There is no adjustment; i. e. , scaling of the result equals 
(exponent) * (operand scaling). 
If both operands are constants, such as in addition, subtraction, multiplication and 
division, the above rules apply with the following consideration. Each of the constant 
operands has a user implied radix point as described at the beginning of this discussion. 
The rules produce an implied radix point for the result. On the other hand, constants 
are converted within the compiler to double precision binary constants with maximum 
precision. Attributed to each internal representation of the constant is the compiler 
generated radix point. Compiler evaluation of the constant expression is performed 
in strict double precision mode. The scaling rules applied to the compiler generated 
radix points yield a compiler radix point for the result of the constant expression. If 
the resultant radix point derived from the user implied radii is greater than the 
resultant radix point derived from compiler generated radii, then the final radix point 
for the evaluated constant expression is the compiler resultant radix point; otherwise, 
it is the resultant user implied radix point. 



II-5-4A/II-5-4B Blank 



i 



M-5035 
Change 3 



5.1.2 Relational Expressions 

A relational expression performs a comparison between two operands via 
rational operators (see Table 5-2). If an operand of a relational expression is an 
arithmetic expression, the operations of the arithmetic expression are executed 
first. Comparisons between two arithmetic operands will be performed in fixed- 
point mode only if both operands are fixed-point. When comparisons are made 
between Hollerith operands, the shorter operand determines the number of 
characters to be compared. If one of the Hollerith operands is a constant, the 
necessary blank filling on the right is made to form equal length operands. A 
relational expression always results in a Boolean true or false value. 

Example 

(A+B+C)*D EQ E+F 

This expression is evaluated by comparing the result of (A+B+C)*D with 
the result of E+F. 
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TABLE 5-2. RELATIONAL OPERATORS 



OPERATOR 


DEFINITION 


ADtTD AMn TVDPC 

COMPARED 




Equal 


ikj. i Lnme l i c , otatus, 
Hollerith, Boolean 


NOT 


1>IU L tiqUd 1 


Mil Lnme Lie i o isius t 
Hollerith, Boolean 


LT 


Less than 


Arithmetic, Status, 
Hollerith 


GT 


Greater than 


Arithmetic, Status, 
Hollerith 


LTEQ 


Less than or equal to 


Arithmetic , Status , 
Hollerith 


GTEQ 


Greater than or equal to 


Arithmetic, Status, 
Hollerith 



5.1.3 Boolean Expressions 

A Boolean expression consists of two or more operands connected by Boolean 
operators. The operands can be considered bit strings, i.e., a string of 
one or more consecutive bits, each having the Boolean value true or false, 
which is internally represented as 1 or respectively. Operator definitions 
and hierarchy of evaluation are defined in Table 5-3. 



TABLE 5-3. BOOLEAN OPERATORS 



HIERARCHY OF 
EXECUTION 


OPERATOR 


DEFINITION 


1 


COMP 


Complement or negation 


2 


AND 


Logical multiply or intersection 


3 


OR 


Logical add or union 


3 


XOR 


Logical difference or exclusive OR 
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If Boo loan operations are contained within parentheses, the innermost operation 
is executed first. 

Example 

A , aft i icaw.P/.d >M1>\(A oh ,&U i/Wi ,C 

The expression is evaluated as follows: 

1. B or C 

2. A AND the result of Step 1 

3. COMP the result of Step 2 

4. The result of Step 3 AND C 

5. A OR the result of Step 4 

Operands associated with logical operations in a Boolean expression may be of 
any type (i.e., Hollerith, numeric, status, or Boolean) or they may be 
relational expressions. If no Boolean operators are used, the operand of a 
Boolean expression must be a Boolean variable, Boolean constant, Boolean 
function, Boolean functional modifier, or a relational expression. If two 
operands result in bit strings of lengths a and b, where a and b are not 
equal, the length of each bit string is assumed to be the maximum of a and b 
with the shortest bit-string filled with zeros on the left. All bit strings 
are right-justified before the binary Boolean operations are performed. In 
arithmetic operations, bit-strings are assumed unsigned, fixed-point data with 
no scaling, j 

The primary use of Boolean expressions is in IF and FIND statements, which 
select statement execution options based on relational comparisons. The 
Boolean expression is also useful for manipulating bit strings and assigning 
values to Boolean data units. 

When the value of a relational expression is used as an operand in a Boolean 
expression, each bit of the required bit string for the operand is assigned 
the value true (1) or false (0). When a Boolean data unit is used as an 
operand in a Boolean expression, it is always assumed to be a single bit in 
length. If the functional modifier BIT specifies a single bit of a data unit, 
that data unit is considered a Boolean operand. 
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When relational and Boolean operators are mixed in a Boolean expression, the 
relational operations are performed first and the resultant Boolean values are 
evaluated according to the Boolean operators. 

Example 

1. A LT B (true or false) 

2. C EQ D (true or false) 

3. (result of 1) AND (result of 2) 

The results of Boolean operations can be shown in a truth table. Referring 
to Table 5-4, the A and B columns represent the assignment of truth values 
for these variables. The remaining columns show the truth values resulting 
from the Boolean operations. For example, if A and B are both false 
(represented internally as 0) then COMP B would be true, A AND B would be 
false, A OR B would be false, and A XOR B would be false. 



TABLE 5-4. TRUTH TABLE 



A 


B 


COMPB 


A AND B 


A OR B 


XOR 








1 














1 








1 


1 


1 





1 





1 


1 


1 


1 





1 


1 






5.1.4 Literal Expressions 

A literal expression is similar to other expressions in that it specifies a 
single literal value expressed in terms of literal operators and associated 
operands. The operands that are allowed with literal expressions are: fields 
and variables typed as Hollerith, Hollerith functions, the functional modifiers 
BIT and CHAR, and Hollerith constants. 
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The operator allowed in a literal expression is CAT (concatenation). When 
Used, it places the rightmost character of the left operand adjacent to the 
leftmost character of the operand on its right. 

Example 

Assume the following variables have been declared with associated initial 
values: 



i v i n i t, i t i n i"i 




in mi 
|P| iVi £ i)i 


W\ II 1 II J 1 1 1 
|4| 1 I I 1 I 1 M 1 


i Wih |S| A 


1*1 


i p i AC\ s \)\ 


1*1 1 1 1 1 I 1 I 1 1 






A A(A)\ 


$j I 1 I I I M I 1 






i/T rt(A)\ 


* 1 1 1 1 Ml 1 1 



then M CAT E CAT S CAT S CAT A CAT G CAT E is equivalent to the Hollerith 
value, MESSAGE. 

5.2 FUNCTIONAL MODIFIERS 

Functional modifiers facilitate easy reference to various parts of data 
structures or indicate an operation to be performed on data. They are 
designated as open and/or closed functions. An open function reference 
generates instructions that are compiled in-line. A closed function requires 
references at run-time to Compiler-supplied routines loaded with the user's 
program. The following formats define the allowable functional modifiers: 



a. 


ABS (data unit) 


b. 


BIT (index, index) (data unit) 


c. 


BIT (index) (data unit) 


d. 


CHAR (index, index) (data unit) 


e. 


CHAR (index) (data unit) 


f. 


CNT (data unit) 


g. 


COR AD (data unit) 


h. 


FIL (file-name) 


i . 


LENGTH (file-name) 


J. 


POS (file-name) 



I I -5-9 



F-5035 



5.2.1 Absolute Value (ABS) Modifier 

ABS is used for referencing the absolute value of a data element or arithmetic 
expression; it. is an open funct ion . 

Forma t 

ABS (data unit) 

Exp 1 ana lion 

ABS Specifies an absolute value operation on the specified 

element. . 1 

Data Unit A data unit or arithmetic expression. 

Examples 

i , A^i(A L \ p Wfi'i) i i I i i ■ i i I i i i 1 i l 1 i i I i i i i i 

i 

The example refers to the absolute value of the variable ALPHA. 

2. AftS.foiMIS ftfiS.i.jg^j), I i i i i i i i i i I i i i i i 

This example refers to the absolute value of the field, SIZE, in the 
item-area CLASS. 

5.2.2 Bit (BIT) Modifier 

BIT is used to reference a string of one or more bits in a data unit. Data 
unit bits are numbered with bit specifying the leftmost bit. This function 
may be open if the starting bit and length specifications are positive integer 
constants and do not require movement across a word boundary. 

Format 

BIT (starting-bit ,number-of-bits) (data-unit) 
Explanation 

BIT Indicates that bit specifications for a data element 

follow. 
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Starting Bit A numeric constant, data unit, or arithmetic expression. 

This bit specifies the initial bit position of the string. 

Number of Bits Optional. A numeric constant, data unit, or arithmetic 
expression. It specifies the number of bits in the string. 
If this option is omitted, the number of bits is assumed to be 1. 

Data Unit The name of a data unit. The data unit cannot be a system 

or local index. 

Examples 

, SUT^MA^P,^ i I i i i i i i i i i I i , 

The string begins in. bit (the leftmost bit) and is five bits long. 
ALPHA is the name given to the variable by a previous declaration. 

2 . &XTiU^\}(AE l r* l ( l H ) sm) t ) l i i i i i I i i i i i 

This bit string begins in bit 6 and is six bits long. The table (subtable 
or like-table) is BETA, the item index is N, and the field referenced is 
SUM. In this example, assume that field SUM has been defined such that 
itoccupies bits 27-16 of a table word. Thus, the bit reference applies 
to word bits 21-16, as illustrated below: 



31 30 



1 27 25 



Field SUM 
20 



16 15 



7 



12 3 4 



Starting bit 
specified in the 
BIT reference 



Length of 
"v bit string 
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3. I BPhTi ( (x> | ) i ( J/? i ^ i P\ i i I I I I I i I I i I i i I i i iii 

This example specifies the single bit in bit-position 6 of variable 
ALPHA. 

This bit string begins in the position specified by the variable START. 
Its length is determined by the value of the variable LENGTH. The table 
(subtable or like-table) is BETA. The item index is N, and the field 
referenced is SUM. 



5.2.3 Character (CHAR) Modifier 

CHAR is used to reference a string of characters in a data unit. Data unit 
characters are numbered with specifying the leftmost character. This 
function may be open if the character string specifications are positive 
integer constants and do not require movement across a word boundary. 

Format 

CHAR (starting-character .number-characters) (data-unit) 
Explanation 

CHAR Indicates that character specifications for the 

data element follow. 

Starting Character A numeric constant, data unit, or arithmetic 

expression. It specifies the initial character 
position of the string. 

Number Characters Optional. A numeric constant, data unit, or 

arithmetic expression. It specifies the number of 
characters in the string. If this option is not 
specified, the number of characters is assumed to 
be 1. 

Data Unit The name of a data unit. The data unit cannot be a 

system or local index. 
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Examples 

1. ^^■fiij^.Agifln^^lSm.'H,).). ii i i I i i iii 

The character string begins in character position 1 and is three 
characters long. The table (subtable or like-table) is BETA, the item 
is 4, and the field referenced is SUM. This example can be visualized 
like Example 2 for BIT, the difference being that this uses character 
counts where there are eight bits per character. 

2. iCiMi^< l ( , di)i( l gifiriA^ l 5</Ki\iji i i i i i i I 

This character string begins in character position 1 and is one character 
long. The table (subtable or like-table) is BETA, the item index is N, 
and the field referenced is SUM. 

5.2.4 Count (CNT) Number of Bits 

CNT furnishes the count of the number of bits set (equal to 1) in the specified 
data element. CNT results in an integer value and may be used in a numeric 
or status expression. This is an open function. 

Format 

CNT (one-word data-unit) 
Explanation 

CNT Specifies the counting of bits set to 1 in the designated 

data uni t . 

One -word 

data-unit The name of a data unit contained in one word. 

Example 

Aa(T7 i/iTiSk id fiXX ;3 ,FiL,>,P|o, s,\)i , 

The number of bits that are set in field FLDPOS of item XX of table .TBLE 
will be counted. 
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5.2.5 Core Address (CORAD) Modifier 

CORAD is used to reference the core address of a data element. It is an open 
f unct ion . 

Format 

CORAD(data-uni t or statement-name) 
Explanation 

CORAD Specifies the core address of the following 

data element or statement name. 

Data Unit or Statement Name A data unit or statement identifier. 

NOTE 

The CORAD modifier always results in an unsigned, 
16-bit value which represents the SY address of the 
data unit or statement' name referenced. Under no 
circumstances will CORAD result in an 18-bit absolute 
address . 

5.2.6 File Position (FIL) Modifier 

FIL is used for file positioning. See Section 6 for usage examples. This 
is a closed function. 

Format 

FIL (name) 
Explanation 

FIL Specifies the positioning of a device to a 

particular file. 

Name The identifier of a file. 
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5 .2.7 Record Position (POS) Modifier 

POS is used for record positioning. This is a closed function. See paragraphs 
6.5.1 and 6.5.2 for usage examples. 

Format 

POS(name) 

Explanation 

POS Specifies the position of a file named within the 

parentheses. 

Name The identifier of a file. 

5.2.8 Record Length (LENGTH) Modifier 

LENGTH is used to determine the length of the last record of an input or 
output operation; it is a closed function. See paragraph 6.7 for usage 
examples. 

Format 

LENGTH (name) 

Explanation 

LENGTH Specifies the length of a record for the file named. 

Name The identifier of a file. 

5.3 PROCEDURE LINKING 

Procedure linking is accomplished through the procedure call, function call, 
the procedure switch call, and the return statement. This capability provides 
for program segmentation and increased efficiency through the elimination of 
statement duplication. Paragraph 4.1.12 gives instructions for declaring a 
procedure. 
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5.3.1 Procedure Call 

A procedure call establishes transfer of control to a named procedure and may 
assign actual parameter values to the formal parameters defined in the procedure 
declaration. 

All procedure input parameter linking is accomplished by transferring the 
values contained in the actual input parameters of the calling statement to 
the formal input parameters of the called procedure declarative statement. 
That is, an actual parameter and its corresponding formal parameter are 
usually distinct programmer-declared data units allocated to different 
locations in core. Therefore, modification of a formal input parameter in 
the procedure does not affect the value of the actual input parameter in the 
calling procedure. Procedure output parameter linking is accomplished by 
transferring the values contained in the formal output parameters of the 
called procedure's declarative statement to the actual output parameters 
specified in the calling statement upon procedure return. If an actual 
parameter is omitted, or if the same data unit is specified as both the actual 
parameter and the corresponding formal parameter, no transfer of values is 
performed. Addresses of data units may be transferred (simulating a call by 
name) by using the CORAD operator (see paragraph 5.2). 

Format 

name INPUT actual-input-parameter( s) OUTPUT 

actual-output-parameter(s) EXIT statement-name(s) $ 

Expl anat ion 

Name Identifies the procedure to be executed, 

INPUT Optional. Specifies that the following list 

of actual parameters is to be input to the 
named procedure. 

Actual Input Parameter ( s) Constants, data units, or expressions that 

replace tin; corresponding formal input para- 
meter values during execution of the named 
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procedure. Actual parameters must agree in 
type with formal parameters. Multiple para- 
meters are separated by commas. There musl 
be a one-to-one correspondence with the formal 
parameters defined in the called procedure's 
declarative statement (see note below). 

OUTPUT Optional. Specifies that the list of actual 

parameters following are the outputs from the 
named procedure. 

Actual Output Parameter(s) Data units whose values are replaced by the 

corresponding formal output parameter values 
after execution of the named procedure. 
Actual parameters must agree in type with 
formal parameters. Multiple parameters are 
separated by commas. There must be a one-to- 
one correspondence with the formal parameters 
defined in the called procedure's declarative 
statement (see note below). 

EXIT Optional. Specifies the statement name(s) 

that follow are abnormal exit reentry points. 

Statement Name An identifier that replaces the corresponding 

formal exit name during execution of the 
named procedure. Program control is trans- 
ferred to the named statement if a RETURN 
(see paragraph 5.3.3) referencing the formal 
exit name is executed. 

NOTE 

If the same data unit is specified as both the actual 
parameter and the corresponding formal parameter, no 
transfer of values is performed. Alternatively, if 
an actual parameter is omitted from the calling state- 
ment, no transfer of values is performed. In this case, 
the position of the actual parameter in the parameter 
list must be maintained with a comma. 
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Since the passing of parameters involves a passing of actual values, if the designated 
parameter is a table, subtable, etc. , the entire table, subtable, etc. , is actually 
transferred into the procedure receptacle. The procedure must, therefore, provide a 
receptacle of sufficient size. Any excess beyond the receptacle size is truncated. 
The CORAD modifier and the INDIRECT table option may be used when a table is 
specified as a procedure parameter and it is desirable not to have the entire table 
passed (see paragraph 4. 2. 2). 

NOTE 

It is not legal to use status constants as actual input or 
output parameters for forward reference procedures 
(procedures which are called before they are formally 
defined or declared with an EXTREF or LOCREF 
modifier). Furthermore, a local procedure may not 
be forward referenced before its local formal para- 
meters are defined or declared, regardless of the 
parameter types. 

Examples 

1- diXi.. i . . . iT.e-iS.TiR, JMP.Kfr, ,0, fltf,T,p-,u,Ti .C^S, 1*1 i i I . 

The statement AX will call the procedure TESTR . INPUT specifies that 
will be passed to TESTR as the actual input parameter value. The actual 
parameter CLAS will receive the output value from procedure TESTR. 

IftCftC ;W^t| APAj, ^Ra-,Q,ur,fl<4,r, g*i**.g; 



I iii i i £ i >< i 3: » T i 1 'A T Pi fa iiili ii ill i ii 



i i j 



The procedure RCAC is to be called. API and AP3 are the first and third 
actual input parameters. The actual parameter IMAGE will contain the 
output from procedure RCAC. If an abnormal exit is taken from RCAC, 
reentry to the calling procedure will be at the statement labeled AT3. 
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procedure. Actual parameters must agrer* in 
type with formal parameters. Multifile para- 
meters are separated by commas. There must 
be a one-to-one correspondence with the formal 
parameters defined in the called procedure's 
declarative statement (see note below). 

OUTPUT Optional. Specifies that the list of actual 

parameters following are the outputs from the 
named procedure . 

Actual Output Parameter(s) Data units whose values are replaced by the 

corresponding formal output parameter values 
after execution of the named procedure. 
Actual parameters must agree in type with 
formal parameters. Multiple parameters are 
separated by commas. There must be a one-to- 
one correspondence with the formal parameters 
defined in the called procedure's declarative 
statement (see note below) . 

Optional. Specifies the statement name(s) 
that follow are abnormal exit reentry points. 

An identifier that replaces the corresponding 
formal exit name during execution of the 
named procedure. Program control is trans- 
ferred to the named statement if a RETURN 
(see paragraph 5.3.3) referencing the formal 
exit name is executed. 

NOTE 

If the same data unit is specified as both the actual 
parameter and the corresponding formal parameter, no 
transfer of values is performed. Alternatively, if 
an actual parameter is omitted from the calling state- 
ment, no transfer of values is performed. In this case, 
the position of the actual parameter in the parameter 
list must be maintained with a comma. 



EXIT 

Statement Name 
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Since the passing of parameters involves a passing of actual values, if the designated 
parameter is a table, sub table, etc. , the entire table, subtable, etc. , is actually 
transferred into the procedure receptacle. The procedure must, therefore, provide a 
receptacle of sufficient size. Any excess beyond the receptacle size is truncated. 
The CORAp modifier and the INDIRECT table option may be used when a table is 
specified as a procedure parameter and it is desirable not to have the entire table 
passed (see paragraph 4. 2. 2). 

NOTE 

It is not legal to use status constants as actual input or 
output parameters for forward reference procedures 
(procedures which are called before they are formally 
defined or declared with an EXTREF or LOCREF 
modifier). Furthermore, a local procedure may not 
be forward referenced before its local formal para- 
meters are defined or declared, regardless of the 
parameter types. 

Examples 

i- AXi.,-, ■ , ! irfis,Tfe j^wlr, ,0, Qd.T,p,u,Ti '.C^flS, ft . ■ I ■ 

The statement AX will call the procedure TESTR . INPUT specifies that 
will be passed to TESTR as the actual input parameter value. The actual 
parameter CLAS will receive the output value from procedure TESTR. 

*■ IRiCAQ SK.PiHTl APAji ^,R3I .Q.ur^u.-n xHA^ t £; 

I I I M lO^Ti 1 \fi\ T fi\ fel l I I 1 11 I 1 I I I I I 1 1 i I 

The procedure RCAC is to be called. API and AP3 are the first and third 
actual input parameters. The actual parameter IMAGE will contain the 
output from procedure RCAC. If an abnormal exit is taken from RCAC, 
reentry to the calling procedure will be at the statement labeled AT3. 
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5.3.2 Function Call, 

A function call establishes transfer of control to a named function and assigns one or 
more values to the formal input parameters of the function. A function call may appear 
in dynamic statements or expressions; it resembles conventional mathematical func- 
tion notation. 

Format 

name (actual -input-parameter, . . . . , actual -input -parameter) 
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Explanation 



Name 



The name of the function to be executed. 



Actual input Parameters(s) 



Specifies each actual input to the function. 
There must be at least one specified; multi- 
ple parameters are separated by commas. 



Example 



The function call for the function TAN is TAN(AX, AY). AX and AY are the actual 
input parameters to be used as the values of the formal input parameters of the 
function. The function is evaluated and provides the value specified to complete 
the operation of the SET statement. 

NOTE 



It is not legal to use status constants as acutal input 
parameters for forward reference functions (functions 
which are called before they are formally defined or 
declared with an EXTREF or LOCREF modifier). 
Furthermore, a local function may not be forward 
referenced before its local formal parameters are 
defined or declared, regardless of the parameter 
types. 



5.3.3 Return (RETURN) Statement 

The RETURN statement is a transfer of control operation used within a given proce- 
dure or function to exit from that procedure or function. There are three types of 
RETURN statements for procedures: a normal RETURN, an abnormal RETURN, and 
a conditional RETURN, dependent on a hardware key setting. All procedures should 
have at least one normal RETURN statement. However, a RETURN statement may be 
omitted if it immediately precedes the END-PROC declaration. There is only one type 
of return for a function. 
Format 

RETURN statement-name special -condition $ 
RETURN (expression) $ 
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1. 



Statement Name 



Explanation 

RETURN Causes a normal transfer back to the statement 

following the procedure -linking operation of the 
calling procedure or function. 

Optional. Must be the same name as one of 
those following the EXIT definition in the proce- 
dure declaration and effects an abnormal trans- 
fer of control to a labeled statement of the calling 
procedure or function. A one-to-one correspond- 
ence is established between EXIT names specified 
in the call and those specified in the declaration 
to effect this transfer. 

Optional. Specifies any of the special hardware 
conditions defined for the target machine. For 
the AN/UYK-7, these aie KEY1, KEY2, KEY3, 
STOP, STOP5, STOP6, and STOP 7 (see para- 
graph 7. 3. 4 for simulating these special condi- 
tions). 

Any legal data name or CMS -2 expression. This 
format is reserved for returning from a function. 
The Compiler will process the expression and 
return the result to the calling procedure. 

Examples 

iP.ftQC^.ftE, I I i i i i i i i i i I 



Special Conditions 



Expression 



I i 1*1 i ' ill! I 



I 111 II I I 



I I I I I I I I I I I 1 



I 1 i i i 



i i *i i i- j i i I 1 i • i » i i i i i i I i i i i i i i i i I i i i » i 



i iiii I) i.l i 1 



I I I I I I I I I 1 1 I I I I I I I I 1 M I I 1 



This is the normal typo of return. Control is transferred back to the 
pmri»<luri* I hut ml Inl. lli'DATK. 
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IPflqQSfrflfts iftEftj), PM\T\?ia IT i 6»ftfi, .b'XiXir, .fcTqfr* 



i i* i i j m i I I i i i I i I 1 ll 1 i I i I i l I l I 1 i i i i i 



i i i i i i i i i 1 i i i i i i i i i 



i I I I i I i I 1 i ) i i 



i i i i i i i i 



1 



ii i i i l i i 



i i i i i 



i i i i i i i i i 1 i i i i i i i i i 



i i i i i i i i 



i i i i i 



1 



i i ' i i i i i i I » i i i i i ' i * 



I i i l l i l I 



ii i ii 



\R&HW A i 1 1 M i i 



1 1 1 1 



1 1 1 1 1 1 ii i i i 1 1 



FMnPlRpft iFjEflft ft m i i 1 



1 I I I I 1 I 1 1 1 I I I I 



The RETURN EOF statement results in a return to the alternate reentry 
statement corresponding to the parameter EOF in the procedure call. 
In this case, the output parameter value is not transferred. 



3. l/?«EiTi//.£Ai . jSTlQft i , i , i 1 , , i i i i i . i 1 i i i t i i 

1 I 1 1 1^1 I 1 I 1 I I I I 1 I I 1 I I I I I I I I 1 i I I I 1 I I 

IREjTMftM , t SJ )p x P£ x rf i , i i i 1 i i i i i i I i i I i i i i i i 

These are examples of special condition returns. The first example 
results in an unconditional halt with the return executed after oper- 
ator intervention. The second example results in a stop if key 5 is 
set, with the return executed after operator intervention; otherwise 
the return is executed. 

<• lfieW,A/, i jSi rfop , ?, , flTflP tSf , , , , i i , | , , , 1 1 i 

In this example, if key 5 is set, a halt will occur. After operator 
intervention, the return will be made through STEP9 to the controlling 
procedure or function. Otherwise, a return through STEP9 is executed 
without halting. 

5. IRiSjTmM ifi*j H-i \Y\ f+t iZji r^l i i i i iii i ill I i i ■ . 

In this example of a return from a function, the expression X+Y+Z will 
be evaluated and returned to the calling procedure as the output value 
of the function. 
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5.3.4 Executive (EXEC) Statement 

This statement provides an interface with an executive program. A call to an 
executive program is generated and a parameter is placed in the appropriate 
register for the executive program to access. The parameters required by the 
executive program are specified by the particular system. This statement 
merely provides the interface capability. 

Format 

EXEC parameter-1, parameter-2 $ 
Explanation 

EXEC Causes a call to an executive program (generation of an 

XS instruction) . 

Parameter 1 A parameter required by the executive program to inform 
it p s to what action is to be taken (this parameter is 
specified by the particular system). This parameter will 
appear in the SY portion of the XS instruction. 

Parameter 2 Optional. A parameter that will be loaded into machine 
register AO prior to execution of the XS instruction. 

Examples 

i. i j^frSf I i$i i i i i i i I i i l ) i I l i i I i i i i i i 

This example provides code 15 to the executive program and requests the task 
associated with code 15 to be performed (i. e. , generates an XS 017 instruction). 



2. ififl^fa 1 1-45] ly |V|ft|6|4Xi I rf I I I I 1 I I II I I i I i . i . 

This example provides the contents of VRBLX to the executive program 
through task register AO. This data unit may either instruct the 
executive program to perform a specific task, or may contain a core 
address for the executive program to access for its instructions. (This 
generated instruction is dependent on the particular system that is 
implemented) . 
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f) . \\ . f) Procedure Switch Call 

A procedure switch call establishes a procedure link by specifying a transfer 
of control to one of the procedures named in the procedure switch declaration 
(see paragraph 4.2). Actual parameters are assigned to formal parameters 
named by the declaration. 

The index value of the procedure switch call determines which procedure within 
the declaration is to be called. If the value of the switch index is outside 
the range of allowable values, control may be transferred to the named statement 
via the INVALID operator. Allowable index values are through n-1, where n is 
the number of switch points. If the user does not use the INVALID option, it 
is his responsibility to see that the index is within the range of the switch. 

If the procedure switch is defined with formal input and output parameters, 
actual input and output parameters must be included in the procedure switch 
call, as in a normal procedure call. 



Format 



name USING index INVALID statement-name INPUT 



actual-parameters OUTPUT actual-parameters $ 



Explanation 



Name 



The identifier of a previously defined P-SWITCH. 



USING 



Specifies that the following index indicates the 
procedure to be called. This parameter is not 
used in a procedure item switch call. 



Index 



A data unit, constant, or arithmetic expression 
whose integer value determines the procedure to be 
called. This parameter is not used in a procedure 
i tern switch call . 



INVALID 



Optional. Specifies that the procedure linkage 
should be accomplished only if the switch index is 
valid. 
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Statement Name 



INPUT 



Actual Parameter 



OUTPUT 



Actual Parameter 



Identifies the statement to which control is 
transferred if the invalid condition is met. 

Optional. Specifies that the list of actual para- 
meters following are the inputs to the named pro- 
cedure switch . 

A data unit, constant, or expression that replaces 
the corresponding formal input parameter during 
execution of a procedure referenced by the 
procedure switch call. Multiple parameters are 
separated by commas. 

Optional. Specifies that the list of parameters 
following are to contain the outputs from the 
named procedure. 

A data unit that is replaced by the corresponding 
formal output parameter after execution of a 
procedure referenced by the procedure switch call. 
Multiple parameters are separated by commas. 



I I -5-24 



M-5035 



Example 

The following declaratives are referenced in the procedure switch call. 





i i i i i i i i i 1 i i i i i i i i i 1 i i , 
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In this example, the procedure switch JCCARD is used to enter a procedure 
using K as an index. STEP1 is the statement to which control will be 
transferred if the index value is out of range for the switch. The 
actual input value to the procedure called is defined by the actual 
parameter IMAGE. The actual output value is specified by the parameter 
ORDER. The second statement would result in exactly the same action 
through the call to the procedure item switch ICARD. 
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5.4 REPLACEMENT STATEMENTS 

Replacement statements provide for the transfer of data from one data unit 
to another, permit performance of algebraic (both 'Boolean and numeric) 
manipulations according to a predefined hierarchy, and provide for the 
simultaneous exchange of values between data units. 

r>.4.1 Assignment (SET) Statement 

Upon execution of an assignment, statement, the value of the right term is 
transferred to one or more specified data units. The four types of assign- 
ment statements are: arithmetic, literal, status, Boolean, and multiword. 

Format 

SET receptacle( s) TO right-term $ 
Explanation 

SET Specifies that one or more receptacles follow, to 



which data from the right term is to be transferred. 



Receptacle(s) 



A data element that is to receive a new value. 



Multiple receptacles that are to receive the same 
value may be specified, and are separated by commas. 
The receptacle type may be arithmetic, literal, 
status, or Boolean. 



TO 



Specifies that the right term follows. 



Right Term 



A data element or expression. Evaluation of the right 
term results in a signle value. The right term must 
agree in type (arithmetic, Hollerith, status, or 
Boolean) with the receptacle. 
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Examples 

1. iSi g i T i i A 1 iTj<3 i \Ek i i^i I i i i i i i i i i 1 i i i i i i i i i I i i 

The value of A is replaced by the value of B. 

2. giE~iTi Ay\ \Bi l \T\C\ | id i^l i i i i m i i i 1 i i i i i i i i i 1 , , 

The values of A and B are replaced by the value of C. 

3. iSiflT, id, ,710, ,B' iTi*,£W iSir.T, ,C, ,TA 4> , |$, , , i i , , , , I , , 

4. i5|g|Ti 6i(MSi ,TA v'SN&fMnEi' . .1. , , , i | I i ■ 

5. 4. 1. 1. Arithmetic Assignment Statement 

The value specified by the right term in an arithmetic statement must be an arithmetic 
expression, which may include numeric functions and functional modifiers. The 
receptacle must be an arithmetic data unit. The following rules must be observed. 
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1. When the value designated in the right term is specified to 
greater precision than that defined by the receptacle, the 
excess precision is truncated. 

2. When the value is specified to less significance than that 
defined by the receptacle, the most significant bits will be 
filled with the sign bit if the field is signed. If the field 
is unsigned, the bits will be filled with zeros. 

3. When the value is specified to less precision than that defined 
by the receptacle, the least significant bits will be set to 
zeros or ones. 

4. When the value has greater significance than that accepted by 
the receptacle, the most significant bits of the value may be 
lost, depending on the actual number of bits allocated to the 
receptacle . 

. r >. The mode of the receptacle defines the replacement as floating- 
or fixed-point . 

6. Any arithmetic expression in the right term involving both a 
floating- and fixed-point data unit will be evaluated in the 
floating-point mode. 

7. Fixed-point replacement aligns the. radix point of the right 
term with the radix point of the receptacle. 

8. The radix point of a receptacle or a right term may be defined 
by an in-line scaling definition. 

Format 

SET recept acle( s) TO expression SAVING numeric-data-unit 
OVERFLOW statement-name $ 

Explanation 

SET Specifies that one or more receptacles follow, to 

which data from the right term is to be transferred. 
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Receptacle (s) 



TO 

Expression 
SAVING 



Numeric Data Unit 



OVERFLOW 



Statement Name 



A data element that is to receive a new value. Multiple 

receptacles that are to receive the same value may be 

specified, and are separated by commas. In this case, 

the assignment operations are performed from right to left, 
Specifies that the right term follows. 

An arithmetic expression. 

Optional. Specifies that the remainder of the last 
fixed-point division performed in the statement is 
to be saved. 

Any variable or field having an arithmetic data 
type. 

Optional. Specifies that a check for overflow 
caused by previous fixed-point (and floating-point, 
if under MONITOR option) arithmetic operations is 
requested. If an overflow condition resulted, all 
overflow indicators are turned off and control is 
transferred to the abnormal path specified by a 
statement name. 

The label of the statement to which control is 
transferred. 



1. 



Examples 



♦SigPl A\ iTjoi \($\+iC^)fi*b\ i£l i ■ ■ i i i i i i I i i i t i i i i i 1 . 



The value of A is replaced by the result of (BK))*D. 
2. \ S l*i T \ A \ T fi\ 1*1-^1^1 I I I I I I 1 I I I I I I I I I I I I I I I I I 1 l 



The value of A is replaced with the constant value .5. 
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3. £l g l T i iTJOj fii & I i 1 I i i I I i I I I 1 i n I I l I ill i 

The value of B, with its declared radix point, will be aligned to a 
radix point of 5 and stored in A. 

4. fil^ 7 "! A 1^1 1^1 I 1 1 I I I III I I I 1 I I I I I I I I I 1 l 

The value of B, with a radix point of 4, will be aligned to the declared 
radix point of A and stored in A. 

5. Pfil T \ A*\*rtl'iT\Q\ i~B*i»i6 #1 i I I I I i I I i hi i l l i I ii I i 

The value of B, with a radix point of 6, will be aligned to a radix 
point of 4 and stored in A (resulting in the loss of two fractional 
bits). An in-line definition is only valid for a particular reference. 
The radix point of a right term that is an arithmetic expression is 
specified by the expression result. 

6. £|g7| \T\0\ p/& \S\*\V\X[A/fr\ j>| |»| | | | | | | M | | | m I 1 i 

The value of A is replaced by the value of the result of B/C. The value 
of D is replaced by the value of the remainder. 

t sjtj, A, jc\ .b/c fiyfXFhaw. ,s.i, 4, , I ..I. 

If a divide overflow occurs, control will be transferred to the statement 
SI. 

a. 'S'STi t F&*M iTjO, l p,L.O,AT" 1 I ,$i i t t . i ! » 1 t , . i t t i i i I i 

Assuming FLOAT was declared as a floating-point variable and FIXD declared 
as a fixed-point variable, the floating-point value of FLOAT is converted 
to a fixed-point value. The variable FIXD is then set to the converted 
value. 
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9. SET RESULT TO A*B+C-D/E $ 

In this example, the required operations would be executed according 
to the predefined hierarchy: ((A*B)+C)-(D/E) . 
10. SET ALPHA TO BETA THEN GOTO ENDJOB $ 

This compound statement transfers the value from data unit BETA to data 
unit ALPHA with conversion as required and then transfers to the location 
specified symbolically by ENDJOB. 

5.4.1.2 Literal Assignment Statement 

A literal SET statement stores in a literal (Hollerith data type) variable the 
value specified by the right term. The right term must be a literal expression 
which includes Hollerith functions, the functional modifiers BIT and CHAR, and 
Hollerith constants. Variables and fields typed as Hollerith and the functional 
modifier CHAR are permitted on the left side of the literal SET statement. If 
the right term is a Hollerith or CHAR-modified data unit, the replacement is 
executed from left to right. Characters are numbered from the left, starting 
with 0. Character of the right term replaces character of the receptacle, 
etc. If the size of the right term is smaller than the size of the receptacle 
and the right term is not a Hollerith constant, the excess characters of the 
receptacle are not affected. If the right term is a Hollerith constant and is 
smaller than the size of the receptacle, the constant is left- justified and 
blank-filled to the size of the receptacle. If the size of the right term is 
greater than the receptacle, the rightmost characters are truncated. 

Examples 

The following declarations will be referenced in the following examples: 
TABLE TAT H NONE 10 $ 
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FIELD CATA H 5 $ 

FIELD FATHOMS H 11 $ 

END-TABLE TAT $ 

VRBL COURSE H 10 $ 

1. SET COURSE TO H(VALLEVERDE) $ 

The Hollerith variable COURSE is replaced by the string of characters 
VALLEVERDE. 

2. SET TAT (0, CATA) TO TAT (7, CATA) $ 

The value of the Hollerith field CATA of item 7 of table TAT replaces 
field CATA of item of table TAT. 

3. SET CHAR(O) (TAT ( 7) , CATA)) TO H(?) $ 

The first character of field CATA of item 7 of table TAT is replaced by 
the Hollerith ?. 

4. SET CHAR (0) (COURSE) TO CHAR (1) (TAT (5 ,CATA) ) $ 

The second character of field CATA of item 5 of table TAT is placed in 
the first character position of the variable COURSE. 
5 . SET BUFFER TO H (DEPTH ) CAT TBLE( J , FATHOMS) r 
CAT H( NO ALERT) $ 
Assuming BUFFER and FATHOMS are typed as Hollerith, the variable BUFFER 
might contain a string of characters similar to the following message, 
assuming that the value 73 FATHOMS was contained in TABLE (J, FATHOMS) . 
DEPTH 73 FATHOMS NO ALERT 

5.4.1.3 Status Assignment Statement 

The status SET statement assigns to a status variable, the value specified 
by a status constant, a status type data unit, or a status type function. 
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Example 



I I I I I 1 I I 



i i i i iVWI i^i t i ii 



I 1 I I I I I I I I I I I I 



III Ml 



I I I ] I II 11 1 I I I I 



I I I I 1 I I i j I 1*1 I 1 I I 1 I I I I I I I I 



1 1 I 1 1 1 1 1 1 1 I 1 1 I 



I I I 1 I I I I I I I I 1 1 I 1 1 I 1 I I I I I I 



I I I I I I 1 I I I I 1 



J L 



1 1 I I I I I 1 1 I M 1 I I 1 1 1 1 I I I 1 I I 



I 1 I I 1 I I I I I I I I I 



I 1 1 11 1 1 1 1 I I 



J— L 



s.gjT, ,«,^£,r < etR.C/<,^,^ l T^ l d^|o,u l T > Y ,t,q 



5.4.1.4 Boolean Assignment Statement 

A SET statement is classified as Boolean by the presence of a Boolean 
expression on the right side of the statement. Assignment of the bit string 
that results on the right side to the receptacle( s) on the left side must 
adhere to the following rules: 

1. If the magnitude (length) of the bit string on the right is 
greater than the receptacle, the bit string is right-justified 
in the receptacle and truncation occurs to the excess bits on 
the left. 

2. If the magnitude (length) of the bit string on the right is less 
than the magnitude of the receptacle, the bit string is right- 
justified in the receptacle and the unused bits are cleared 
(set to 0) . 
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Examples 

1. 5 £171 iT[£[£\ I JIG i dU i 4\ I i i i i i i i i i I i i i i i i i i i 

This example assigns the value 1 to the Boolean variable TEE. 

2. VifiT? ,7-iCf, IrA i&r,nfiM l fl71fM l P l ')i , i I i ,,,,,,, i 

The variable TEE is assigned the value of the zero bit location in 
variable TRAP. 

The variable ALPHA is assigned the logical product of the Boolean value 
of the relational expression BETA GT GAMMA with the Boolean value of the 
variable DELTA. 

•i. »5 f ' r ' AM\Ai .r,o, iftcrMj for, <SVWi*, ,/*KD, t A5iiM, , i 



i i i i i i i i 1 I i i i i i i i i 1 i i i 



Assume: 

a* ALPHA is a 16-bit integer variable. 

b. DELTA is a 32-bit integer variable filled with the octal 

constant 0(30707070707). 
c* BETA and GAMMA are floating-point variables, 
d. TBLE (J, K) contains the value 0(25252525252) . 

Since DELTA and TBLE(J, K) are not Boolean data units, they are treated 
as bit strings for the purposes of the evaluation of this Boolean 
expression. In this context, the Boolean result of the relational 
expression BETA GT GAMMA is an arbitrary string of or 1 bits. If 
BETA is greater than GAMMA , ALPHA will contain 0(020202) . If BETA is 
not greater than GAMMA, ALPHA will contain (16 bits cleared). 
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5.4.1.5 Multiword Ass ignmont Statement 

This statement assigns a value or values to a multiword data element. There 
are three types of multiword assignment statements: 

1. Table-to-table. 

2. Item-to-item. 

3. Single word-to-multiword. 

5.4.1.5.1 Multiword Table-to-Table Assignment Statement . This statement 
assigns the values of one table to another table. Since this is a block 
transfer, care should be taken to ensure that both table structures are 
similar and that the item size is identical. If the number of words in the 
receptacle is less than the right term, the excess words are lost. If the 
number of words in the receptacle is greater than the right term, then the 
extra words are not affected. This type of statement applies to subtables 
and like-tables as well as to tables. When vertical tables with major indexes 
appear in a table-to-table assignment, the major indexes will be used to 
determine the number of words to be transferred. 

Example 

The following declarations are referenced in the following multiword 
table assignment example: 

rn*iftL|gi 1 1 l i iPi*ifri5 M rfl Af\Q\ & m 1 1 1 1 1 1 1 1 1 1 1 I 

l*l l l i l I i i l l l l I l I l l l I i I I I 

.rtABiL^i mI i iBiWirti iM 14. \LQPi & i i l i i i i i i i i i I 

i^^-iMAHE, \BfaNM(*\ i$i 1 i . ■ i i i i i i I i i i i i i i . i I 

i m n i I i I I i i r i i t l i 1 i i i i I i i i i I i i i i i i i i i I 

I II I II II 1 1 I I M I ) 1 I 1 1 I I I I I I I I I I 1 M I I I I I 1 

I I I I I I I I I I I I M I I I I 1,1 I I I I I I I I 1 I I I I I I 1 I I 1 

,5,^, fiwm m MAfi l*n n i n i i I I i i t i i n i 1 

The words of table BXNUM are replaced by the words of table PAGE. 
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5.4.1.5.2 Multiword Item-to-item Assignment Statement . This statement assigns 
the values of one table item to another table item. If the number of words in 
the receptacle is less than the right term, the excess words are lost. If the 
number of words in the receptacle is greater than the right term, the extra 
words are not affected. For this replacement, an i tern-area i s considered to 
be the same as an item. 

Examples 

The following declarations are referenced in the following multiword 
item replacement examples: 

iTiAftiifc"; i i 1 i jiAtPi 1H1 i jl i ij; i tjri i i i i i i i i i i i 1 1 i 



i i i I I i i 



FMbr WMZi hWi i * i i i 1 i i i i i 



i i 



i i i i i i i i i i 



i ii ii ii ii 



I I I I I I II I M 



I 1 I I I I I I I I I 



i. 



i t i > i ill 



1. . Set .w.fk). iTTQ aecfliA $ I 1 

All of the words of item of table IMP are replaced by the words of 
item 1 of table DEC. Note that IMP is a horizontal table and DEC is 
a vertical table. 

2. A^P! fo E A Ita £ATjj ^ 1 i i i i i m i i 1 i i i i i i i i i I 

All words of each item of DEC are replaced by the words in item-area 
CAT1. 

5.4.1.5.3 Single Word-to-Multiword Assignment Statement . This statement 
assigns a single word value to every word of a multiword table element (table, 
subtable, like-table, item-area, or item of a table). When a vertical table 
with a major index appears in ihis type of assignment statement, the major 
index will be used to determine the number of words affected in the table. 
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Examples 

The following declarations are referenced in the examples: 





1 ^91 Tin .AT i lAtaAtX&iAi i .4 . I4i 


I 1 


1 1 1 1 1 I 


1 


iS^-fWLie, fotjA , $ | a i 1*1 i i i i i 




Mini 


1 


ifil,6",Lj>i i i 1 i \C\A\T\ii I i5i . A i i i i 1 i 


1 i 


1 1 1 1 1 1 


1 


iir^fo i i 


i i44 r #i i iM h 5 ! i i^i i i i i 1 i 


1 1 


1 1 1 1 1 1 


1 




E\ idAiTiTi i^i » t i i 1 1 i i i i i 


1 1 


1 1 1 1 1 i 


1 




I iWi/t|0|L,Ei i iA i Ji i iZ^iJijrfl i 


A 


1 1 1 1 1 1 


1 


ifiliffUh i i 


i wl, , a ><, lu. .a i*i i i i 


1 1 


1 1 1 I 11 


1 


iFine-|i-a>, i i 


i m i ffi |W, ,4 ft | , 


1 1 


1 1 1 1 1 i 


1 


ifiii€iUft , , 


« .WJ, ..JI'AZI «, iM i*. 1 . 


1 1 


1 1 1 1 1 1 




IMftue, ^.^o.L.r, | ,,,,,,,,, | , 


Li 


1 1 1 1 1 1 


1 


fi I l i 




1 1 


1 t 1. 1 1 1 




iWM i i i 






MWi , , , 


| |AX|F|1h/I,6| iH £l 1 1 1 1 1 1 1 1 1 


1 t 


1 1 1 1 1 1 





1. i5£|Ti wtttqME) rnq i £fi i h i m i » 1 1 1 1 1 1 1 1 1 1 n 1 1 

Every word of table WHOLE is set to 15. 

2. ftSiTj i iC^TIT! XA i tft lii I i i . i i i t i i I i i i » i i i i i 1 

The table CATT is cleared to zeros. 

3. fiSTi i iflftTtTi \TA i I & ! , , , , , , 1 , , , , , , , , , 1 

Every word of CATT is filled with the value contained in the variable 
LIB. 

4. ACT, , ,M,Tf*, ,ttq i ^o,d£ia iy 2 IJ ,3, Jl w,ji y & , , ,,, , ; 

Each word of the subtable GATA is assigned the value of the field W3 
of item 1,2,3 in table WHOLE. 
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Each of the three words in the item specified by 0,1,0 of table WHOLE 
is assigned the value of the arithmetic expression LIB.. 2*4. 

6. iSflTT iQdirixktldi i i7tQ i iCto ^Pi A i | i I i i i i i mil . 

Each word of item 1 of table CATT is filled with all or part of the 
characters of the Hollerith variable COMAP. For example, since the 
AN/UYK-7 machine word size accommodates four characters, the characters 
REUK would be stored in each word of the item. 

7. iSgjTi MTfll i iTTOi i AfttiLVIA i i^Pi i i i i I i i i i i i i i i I 

Each word of subtable CATA is replaced with the true or false (1 or 0) 
value of the Boolean variable AXFLAG. 

5.4.2 Exchange Statement (SWAP) 

The exchange statement swaps the values contained in two data units. The 
exchange statement may be viewed as two assignment statements that are 
executed simultaneously. The rules regarding data unit lengths and types in 
the exchange statement are the same as the rules for the assignment statement 
(see paragraph 5.4.1.1). However, both the left and right terms assume the role 
of the receptacle. 

Format 

SWAP data-unit data-unit $ 
Explanation 

SWAP Specifies the operation SWAP. 

Data Unit The identifier of a data unit. 



< 
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Examples 



1. g^iftfi i ■ i l^.ftTii 3 i , ,CiRJ\Z , ■ , i i i I i i i i , i i , i I 

2. &K*iPi 1 1 1 iftkiWi 3 t zixiU^ 1 1 1 1 1 1 1 1 1 1 1 1 

a. S^P, , , i VAr^Afiir^ y ,C^ l r/iX l ^i|„e l >a,r l B t ) l ■ I 



5.4.3 Shift (SHIFT) Operation 

The SHIFT operation moves the contents of a data location into either the 
same or a different data location. During the operation, the data is shifted 
as prescribed. 

Format 

SHIFT data-unit shift-type shift-count INTO data-unit $ 
Explanation 

SHIFT Specifies the operation. 

Data Unit The identifier for a data unit (two words or less in 

length) . 

Shift Type One of the following: 

CIRC Specifies circular shift. 

ALG Specifies algebraic shift (sign fill). 

LOG Specifies logical shift (zero fill). 

Shift Count Specifies the number of positions to shift and the 

shift direction. This may be a constant, a data unit 
or an arithmetic expression. A negative shift count 
denotes a shift to the left, a positive shift count 
denotes a shift to the right (the sign must be explicitly 
specified for a left shift) . 

INTO Optional. Specifies that the receiving data unit's name follows. 
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NOTE 

The SHIFT statement is intended primarily to provide high- 
level access to the shift instructions in the AN/UYK-7 
repertoire. Consequently several restrictions and limitations 
are imposed: the data-unit being shifted must not exceed 64 
bits in length; partial-word circular shifts are not permitted 
(i. e. , if CIRC is specified, the source data-unit must be defined 
as exactly 32 or 64 bits, or 4 or 8 characters); when a 
receptacle data-unit is specified, the normal data-type rules 
for assignment statements must be followed and the shift opera- 
tion itself is independent of normal operand alignment or con- 
version which takes place prior to the assignment; because all 
left shifts must be performed using AN/UYK-7 circular shift 
instructions, left algebraic shift operations can result in filling 
to the right with magnitude bits. 

Examples 

1. &H\%fj\ > JT/ViT; i { uoA i r\Z i £\ iVi i i 1 i i i i i i i i i I 

2. .s,/fjjF,ri , iMOiart , icaftfl i zwc,//, , ama . moxurx M 

i i i i i i i iPlftiDi iffliB^i^Fyr, h A i i i i I V i M m M i I 
5.4.4 Pack (PACK) Operation 

The PACK operation requests packing of specified data units into a specified data area. 
Format 

PACK data-unit WITH data-unit data-unit ... data-unit $ 
Explanation 

PACK Specifies the operation. 

Data Unit The identifier of a data unit. 

WITH Specifies that the data units which follow are to be packed into 

the receptacle. 

The effect of the PACK statement is bit string transfers from the source location to the 
target area, where the strings are stored consecutively and without spacing. If the 
receptacle is a table or an item, the right side data units must be tables or items. If the 
receptacle is a variable or field, the right side data units must be variables or fields. 
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Example 

ifWCiK! QtMlP. HWMi ■to.dMj. .FjW.l^ ffl/W^i ^.W.M). ^, 

Assume: 

a. COON is a half-word variable. 

b. ANG is a 40-bit field. 

c. LAT(L) is a three-word field in item area LAT. 
The variable QUAD will receive the following contributions: 



(GOON)! 


1 

ANG I 


(LAT(L) ) 


1 — 

1 

*4 


m » j m 


»T* 


._ i 


» 



Word Word 1 



Word 2 Word 3 Word 4 



presuming that QUAD is a storage area capable of containing the 
specified bit strings. 

5.5 CONTROL STATEMENTS 

A control statement alters or affects program flow within a procedure. There 
are three types of control statements: 

1. GOTO statement name 

2. GOTO switch name 

3. STOP 

5.5.1 GOTO Statement Name 

This statement performs a transfer to a named statement and may specify a 
governing special condition imposed by a console hardware switch. 



Format 



GOTO statement -name special-condition $ 
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Explanat ion 

GOTO Specifies a transfer of control. 

Statement Name The name of the statement to which control is to be 

transferred . 

Special Condition Optional. Specifies a machine-dependent condition 

.of .the console key settings. For the AN/UYK-7, 
these are KEY1 , KEY 2 , KEY3, STOP, ST0P5, ST0P6 and 
STOP 7. 

I^xamples 

1. &flTiQ i i iLiRA^fi i 1 i i i i i i i i i 1 i i i i ii i i i 1 

Execution of this statement transfers program control to the statement 
labeled UPDATE . 

2. 6iQr t Q ! , ^^fe , , lK,g,yJL i A i i I i i i i a i i i i I 

A transfer is made to statement label ERRDIAG if console key 1 is on. 

3. 6*>iTA i i W-iLTiflAUr.g , ISr,0,PiJT i^' ' ' I i i i i i i i i i I 

If console ST0P5 is on, program execution halts. When restart is 
accomplished, a transfer is made to statement label ALTRNATE. 

5.5.2 GOTO Switch Name 

This statement performs a transfer of control to a statement label listed 
within an index- or item-switch declaration. Transfer may be made conditional 
as governed by a specified console key setting. 

1. Referencing an Index-Switch. 

Transfer is based upon the value of the switch index. This 
value is specified in the GOTO statement. No check is made by 
the Compiler as to the validity of the index. Therefore, if 
the index is outside the range of switch index values, program 
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execution control can be lost. To prevent this, specification 
of the INVALID operator directs the Compiler to perform a 
validity check; if the index is outside the range of index 
values, control will be transferred to a programmer-supplied 
statement label. 

Referencing an Item-Switch. 

The value of the variable specified in the item-switch is 
compared against the list of constants defined in the switch 
declaration. If a match is found* transfer is made to the 
corresponding statement name. If a match is not found, control 
is transferred to the next statement or to a statement specified 
after the INVALID operator. 



Format 



GOTO switch-name value INVALID statement-name special-condition $ 
Explanation 

Specifies a transfer of control. 
The name of the referenced index- or item-switch. 



GOTO 

Switch Name 
Value 



Special Condition 



INVALID 



A constant, arithmetic expression, or data unit 
that provides an index value pointing to a switch 
point. This parameter is not to be used when 
referencing an item-switch. 

Optional. Specifies the machine dependency conditions 
to be imposed by console key settings. KEY1, KEY 2 , 
KEY3, STOP, STOPS, ST0P6 , and ST0P7 are the CMS-2 
identifiers used for the corresponding key settings 
on the AN/UYK-7. 

Optional. Specifies a transfer of control to the 
following named statement if the index is outside 
the range of the index-switch values or if no match 
is found in an item-switch. 
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Statement Name 



Control is transferred to this statement if the 
switch test is invalid. 



Examples 

The following declarations are referenced in the GOTO switch examples 
l^l 8 ! 1 -! I I I Pi I f£l I 1 I I I 1 I I I 1 I I I I 1 I I I 1 I I I 1 I I I 

Wi^M i i iSftA a i Bi*fl,i iti i ii i i i i i I 1 



i Wh i i i W i 1 * 1 i i 



i 1 i i i i i i i i i 1 i i i i i i i i i 1 



ftvftTfyHi i [s^g \( m (S\^[ tfin i i i i i i I i i i i i i i i i 1 



I I 1*|P|)| l 1 IS I B|j| i$i i i 



I 1 I I I I I I I I I I I I I I I I 1 I I 1 



I I I I l s l3*l 1*1 I I 



I 1 I l I I I I I I I I I I I ii" n 1 



.2,0 



' i » » ' ' i » i I » » * » I i i i » 1 



1 i i I I l 1 I 1 I I I I 1 I I I I I I 



jfrQTiOi i iSi^Ai i 03 i & i i I i i i I i i i i i 1 i i i i i i i i i I 

Program control is transferred to the switch point of SWA specified by 
I. For example, if I equals 2, control is transferred to statement SA3, 



' i i I i i i i 



J 



This is the same as Example 1, except that if I is outside the valid 
index range, control is transferred to statement SA4. For example, if 
1 equals 4, control is transferred to SA4. 

GjOjTA I fi^fo I 1^1 | 1 1 I I 1 I I I 1 I I I I 1 1 I I I I I I I I I 1 

Program control is transferred to the statement corresponding to the 
value in SWX. For example, if SWX equals 30, control is transferred to 
statement SB2; however, if SWX equals 35, program control continues to 
the next sequential statement. 
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4. &QTP, , 6.WIB , , X,M>».LX1>\ , ,5.0,4. , , i , I , , ■ I 

This is the same as Example 3, except that if the value of SWX is not 
found in the switch definition, control is transferred to statement SB4. 
For example, if SWX equals 40, control is transferred to SB4. 

5. (aQTiQ ) t^lH^I I A I iKl^l^l I ^1 II i 1 I I 1 I I I I I I 1 i 1 I 

Program control is transferred to the statement labeled SA2 if console 
key 1 is on. 

5.5.3 STOP Statement 

The STOP statement temporarily suspends program execution. This statement is 
legal only in programs being compiled to execute in the executive state. 

Format 

STOP special-condition $ 
Explanation 

STOP Specifies a suspension of program execution. 

Special Condition Optional. Specifies machine dependent conditions 

of the console key settings. 

5.6, DECISION STATEMENTS 

The IF operator allows for conditional execution of one or more statements. 
The condition is based on one of the following four types of decisions: 

1. Logical 

2. Search 

3. Validity 

4. Parity 

A decision statement may be followed by the ELSE operator which allows for execution 
of one or more statements if the result of the condition is false. 
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5.6.1 Logical Decision Statement 

The logical decision statement evaluates a specified Boolean condition and 
reduces the evaluation to a true or false result. 

Format 

IF Boolean-condition THEN statement(s) $ 
Explanation 



IF 



Specifies that an evaluation, resulting in a Boolean 
true or false condition, is to be made. 



Boolean Condition Specifies a Boolean condition, defined in CMS-2 

notation by operands (constants, data units, and 
arithmetic expressions) and relational or Boolean 
operators ... ' . 

THEN Specifies that the statement or statements that 

follow are to be executed only if the result of the 
Boolean condition is true. 

Stat emen t ( s ) A simple or compound statement, or a block of dynamic statements. 

See paragraph 5. 8 for an explanation of blocks and the requirements for compounding 

(nesting) decision statements. 

Examples 

i. fiff i rti ffl B iTiftiEfti (rDt\°\ r^i i i 1 i M i i i i i i 1 
$\ € \ T \ til \Tfi\ fi\ f+i A i ffr 1 m i i i i i I 1 1 i i l I 1 1 l M I 

Control is transferred to statement Si when A equals B. Otherwise, 
the set statement is executed. 

1 1 i i T A*M tS)Ci T i i*i iTj^ iq i t*i i 1 1 i I i 1 i 1 1 i i i I i i I 

C is set to D, and E is set to F when A+B is less than or equal to B*C. 
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Control is transferred l o statement KVALWTIIR if the sunns of ULVIIIFK 
is 'RAINY' . 

JiF, ,ti iAijjJI ifi 1QR1 .fe. AtT. itfi a)| .r.M^Wi , i . 



1 



1 I I 



I rl I 1 I 1 I I I I I I I 1 I I I I l I II I I 1 



It' the Boolean variables F and F arc both true (1), or i 1" (i is yrralcr 
I han H and the Boolean variable I is true, then control is transferred 
to stal iwnl' SI. 

Ji Pi iBAQLi l-rvheWi 61O1T1C1 hT7g.ci.ri ^1 1 1 1 I 1 1 1 1 1 1 1 1 1 I 

If the? Boolean variable 1 BOOL is set to the true state (1), program control 
is transferred to the statement labeled TRUF. 



SF. ,QQMP.CiB,OA^. ,T.Mr/>| AO,TA .FAtSlf. 6 



''''' 



i 



If the Boolean variable BOOL is set to the false state (0), taking the 
complement will make it true; hence, the true path is taken with program 
control transfer being made to statement FALSF. 

1 1 1 iS»£iTT iflOiftEi ffiOi < Vti'l ir^^i 1 1 1 1 1 1 1 1 1 1 1 1 1 1 



1111 



1 LI 



1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 i 



The relational expressions (GT and FQ) are first evaluated and reduced 
to a true or false condi t ion . These two results are then logically 
tested (AND) for the final determination of a true or false condi t ion. 
If evaluated true, the status variable CODE is set and program control 
is transferred to statement PROCFSSA. 
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5.6.2 Table Search Statement 

The table search statement provides the capability of searching a table for data 
that satisfies specified end conditions. The statement is a combination of a 
FIND statement and a search decision statement. 

The FIND loop is terminated when the value of the table element, specified by 
the index, first satisfies the condition. If the condition is satisfied, the loop 
index points to the element that satisfied the condition. The loop is also 
terminated when the index has reached its final value. 

The FEND statement must always be followed immediately by a search decision 
statement, which may in turn be followed by an ELSE statement (Paragraph 5. 6. 5). 

5.6.2.1 FIND Statement 
Format 

statement-label. FIND expression VARYING loop-index 
initial-value final-value increment $ 

Explanation 

Statement Label. Optional. The name by which this statement is 
referenced. This label is required if the table 
search is resumed. 

FIND Specifies a table search. 

Expression A relational expression, the first term of which 
must be a subscripted table reference using the 
loop index. 
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VARYING Optional. Specifies that the operands that 

follow, control the loop. If not included, the loop 
index is varied from in increments of 1 within 
the limits of the table. The loop index, initial 
value, and final value are allowed only if 
VARYING is given. 

Loop Index Optional. The name of an index or integer variable 

to be varied. It must be included whenever 
VARYING is used and it must be one of the 
subscripts included in the table reference. If the 
VARYING clause is omitted, the first subscript in 
the table reference will be used as the loop index. 

Initial Value Optional. FROM followed by a constant, arithmetic 
expression, or data unit that specifies the beginning 
index value of the loop. If omitted, the initial value 
is 0. 

Final Value One of the following: 

1. May be THRU followed by a constant, 
arithmetic expression or data unit. This 
value signifies the last pass through the 
loop. 

2. May be WITHIN followed by the name of a 
horizontal or vertical table, subtable, or 
like-table. The value assigned is the 
number of items defined for the table or 
the current value of the major index. 
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Increment 



Optional. BY followed by a constant, arithmetic 



expression, or data unit. If this value is to be a 



decrement, BY must be followed by a minus sign. 
If omitted, the increment is 1. When varying 
within a table by a negative value, the initial value 



is the number of items defined for the table or the 



major index, and the final value is 0. 



5.6.2.2 Search Decision Statement 

The search decision statement must immediately follow a FIND statement. 
The FOUND/NOTFOUND condition is determined by the results of the FIND 
search. 

Format 

IF DATA FOUND THEN statement(s) $ 

IF DATA NOTFOUND THEN statement(s) $ 

Explanation 

IF Specifies that a condition is to be evaluated as 



true or false. 



DATA 



A compiler control word used to clarify the 



statement. 



FOUND 



Specifies the condition to evaluate upon 



satisfaction of the FIND condition. 



NOTFOUND 



Specifies the condition to evaluate when the 
search loop is completed. 



THEN 



Specifies that the statement or statements that 



follow are to be executed if the FOUND or 



NOTFOUND condition is true. 
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Explanation 

ELSE Specifies that the statement or statements that follow 

are to be executed only if the result of the Boolean 
condition in the corresponding previous decision statement 
is false. 

Statement(s) A simple or compound statement, or a block of dynamic 
statements. 

See paragraph 5. 8 for an explanation of blocks and the requirement for 
compounding (nesting) decision statements. 

Examples 

1. IF A EQ B THEN SET C TO D $ 
ELSE SET C TO 1 $ 

C is set to D if A equals B. Otherwise C is set to 1. 

2. IF BOOL THEN PROCA $ 
ELSE BEGIN $ 

SET E TO F $ 
SET G TO H $ 
END $ 
PROCB $ 

If the Boolean variable BOOL is true, then procedure PROCA 
is called. If BOOL is false, then the block of set statements 
is executed. In either case, PROCB is then called, 

5.7 LOOP STATEMENTS 

Loop statements direct repeated execution of a specified group of statements (vary 
block) or perform a table search. 

II-5-50A 
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5.7.1 Vary Block Statements 

A vary operation is used to execute one or more statements a specified number of times 
(at least one time). The statements to be executed are bracketed by a VARY statement 
and an END vary statement. This group of statements is defined as a vary block. 
The number of passes through the loop is controlled by a loop index. Multiple vary 
loops on the same level are allowed within the same VARY statement. 
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Statements ) A simple or compound statement, or a block of 
dynamic statements. 

5. 6. 2. 3 Table Search Format 

A generalization of the FIND statement in combination with the required search 
decision statement follows : 

1. FIND statement $ 

IF DATA FOUND THEN . . . (found sequence, with or without 

RESUME) ... $ 

(search completed sequence, should not RESUME) 

2. FIND statement $ 

IF DATA NOTFOUND THEN . . . (search completed sequence, 
> ■ should not RESUME) ... $ 

(found sequence, with or without RESUME) 

The search completed sequence in the first case and the found 
sequence in the second case may be ELSE statements. 
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5.6.2.4 Table Search Examples 

i i i i i , r i i lr.fi ^.Tfti tAfoir^a^, ,r^£iM , , . i i , , , i , 
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'TARGET' is compared against field PLOT A in table FAR, starting at 
item and continuing until an equivalence is found or the complete 
l able has been searched (not found) and an exi t made to AVERAGE. If 
l he FIND is satisfied before the complete table has been searched, 
control is transferred out of the loop and the remaining items are not 
searched. The variable K is the loop index. 

a. iSfrfjPAti i i l^fl m \£\*\ T \ C \ iii i i i i I i 
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i 1 1 1 1 1 1 1 1 
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This sequence of statements increments TALLY each time the third word 
in the first seven items of CATD equals CATC. If no equivalence is 
found or the varying portion of the FIND is satisfied, control is 
transferred to STEP2. The RESUME statement continues the search only 
if an equivalence has occurred. It is not logical to resume a FIND 
loop on a not-found condition since the search continues without 
reinitialization. In the example, STEP2 will always be executed whether 
or not data is found, since completion of the table search will be 
interpreted as a true NOTFOUND condition and exit will be via THEN 
GOTO STEP2. 
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The following three examples illustrate a table search for a specified 
condition using a FIND statement with a search decision statement of FOLNL) 
and NOTFOUND, respectively, in the first two examples, and a VARY block in 
the third example. All three examples produce the same result: a transfer 
to ALARM is made if the specified condition is met less than five times 
during ihe search; otherwise, processing continues with the next instruction 
in sequence. 

■v i i i i i i i i i I gigVTT \KQU)N\1\ iTfli ifl i^i i ! I i i i i i i i i i I , 
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5.6. 3 Validity Decision Statement 

The validity decision determines whether a subscripted data reference is valid. For 
example, if a horizontal table is defined with four items, any reference with the item 
index larger than 3 would be invalid. 

Format 



IF table-element VALID/INVALID THEN statement(s) $ 



II-5-54 



M-5035 

Change 4 



Exulana t ion 
IF 

Table Element 
VALID/INVALID 
THEN 



Statement (s) 



Specifies that a decision is to be performed. 

A subscripted table element where the subscript 
calculation is checked for validity. 

Specifies a condition of a valid or invalid 
subscript . 

Specifies that the statement or statements that 
follow are to be executed if the table element 
reference is VALID or INVALID. 



A simple or compound statement or a block of dynamic 
statements. 

Examples 

The following declaration is referenced in the va 1 id i t y dec i s ion examples 

I 1 1 1 I I I i I I I I 1 



l 7 »lfl^l £l I I |M 1 ffi I l8 1 & 1 1 I 
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Program control is transferred to statement SI if I has a value of 
or 1 . 



Program control is transferred to statement SI if I is not zero. 
5.6.4 Parity Decision Statement 

The parity decision statement determines parity by testing the data specified 
for an odd or even number of 1-bit settings. If the sum of the 1-bits 
contained within the data unit is an even number, the parity is considered 
even. If the sum is an odd number, the parity is considered odd. 
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Format 

IF one-word data-unit ODDP THEN statement(s) $ 
IF one-word data-unit EVENP THEN statement(s) $ 

Explanation 

IF Specifies that a condition is to be evaluated as true 

or false. 



One-word 
data-unit 

ODDP/EVENP 



THEN 



Statements ) 



The identifier of a data unit contained in one 
word. 

The decider as to whether the parity condition of the 
value contained in the data unit is odd or even. 

Specifies that the statement or statements that follow 
are to be executed if the ODDP or EVENP condition 
is true. 

One or more (connected by THEN) dynamic statements. 



Example 

The bits set to 1 in the variable STAT are tested to see if their sum is an 
even number. If so, the variable FLAG is set to 0. 

5.6.5 ELSE Statement 

Any of the four types of decision statements may be immediately followed by an ELSE 
statement which allows for execution of one or more statements if the result of the 
condition is false. 

Format 



ELSE statement(s) $ 
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Explanation 



ELSE 



Specifies that the statement or statements that follow 



are to be executed only if the result of the Boolean 



condition in the corresponding previous decision statement 



is false. 



Statement(s) 



A simple or compound statement, or a block of dynamic 



statements. 



Refer to paragraph 5. 7 for an explanation of blocks and the requirement 
for compounding (nesting) decision statements. 

Examples 

1. IF A EQ B THEN SET C TO D $ 
ELSE SET C TO 1 $ 

C is set to D if A equals B. Otherwise C is set to 1. 

2. IF BOOL THEN PROCA $ 
ELSE BEGIN $ 

SET E TO F $ 
SET G TO H $ 
END $ 
PROCB $ 

If the Boolean variable BOOL is true, then procedure PROCA 
is called. If BOOL is false, then the block of set statements 
is executed. In either case, PROCB is then called. 
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5.6.6 Nested Decision Statements 

Because the connector THEN serves a special/ purpose within decision statements, 
IF and FIND statements cannot directly appear after THEN or ELSE associated 
with an IF statement. However, the compiler interprets all statements within a 
statement block (Paragraph 5. 7) as the equivalent of a simple statement. This 
provides the means of nesting decision statements and gives rise to the following 
rule: 

If an IF or FIND statement is to appear following the connector THEN or the 
operator ELSE associated with another decision statement, the nested IF or 
FIND statement must appear within a statement block. Furthermore, when a 
statement block appears within an IF statement, execution of all statements 
within the block is subject to the condition of the IF statement. 

Examples 

1. IF A THEN 

Bl . BEGIN $ 

FIND TAB(I) EQ B $ 

IF DATA FOUND THEN SET F TO 1 $ 
ELSE 

SET F TO $ 
END Bl $ 

ELSE 

B2. BEGIN $ 

IF B LT 10 THEN SET B TO B+l $ 
ELSE 

VARY I WITHIN TAB $ 
SET TAB(I) TO $ 
END $ 
END B2 $ 
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In this example, the outer decision statement is logically 
equivalent to the form : 

IF A THEN block Bl ELSE block B2 $ 

The BEGIN and END statements are necessary due to the nested FIND 
statement in Bl and the nested IF statement (with its nested VARY loop) 
in block B2. 

2. IF STATUS EQ 'START' THEN 
SET STATE TO THEN 
VARY I WITHIN ANS $ 

SET ANS(I,SUM) TO $ 
END THEN 
COMPUTE $ 
ELSE FINISH $ 

In this example, the VARY block is the equivalent of a simple 
statement within the compound conditional portion of the decision 
statement. 

5.7 STATEMENT BLOCKS 

A statement block is a group of simple or compound statements initiated by a 
BEGIN, VARY, or FOR statement and terminated by an END statement. A 
statement block is interpreted by the compiler as the equivalent of a simple 
statement. A value block (Paragraph 5. 7. 3. 2) is a special block used only in 
the construction of FOR blocks; a value block is not the equivalent of a simple 
statement. 
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5.7.1 BEGIN Block 
Format 

statement-label. BEGIN $ 

• ■ 

dynamic statements 



END statement-name $ 



Explanation 
Statement-label 

BEGIN 
END 

Statement-name 



Optional. The name by which the block is 
identified. 

Specifies the start of a block. 

Specifies the end of a block. 

The name, if any, given to the block as 
specified in the BEGIN statement. 



The BEGIN and END statement brackets serve only to delimit statement blocks; 
the BEGIN statement does not specify a dynamic processing function as does the 
VARY or FOR statement (Paragraphs 5. 7. 2 and 5. 7. 3). Because the BEGIN 
statement does not define a loop structure, it cannot be resumed. Statement 
blocks delimited by BEGIN and END may be nested within, and in the same 
manner as, VARY blocks and FOR blocks. 
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Example 

LI. BEGIN $ 

SET A TO B $ 
VARY I WITHIN TAB $ 
BEGIN $ 

SET C TO D**A $ 

IF C LT 100 THEN SET TAB(I) TO C $ 
END $ 

SET A TO A+l $ 
END $ 
END LI $ 

Three statement blocks are defined in the above example: an outer block, LI, 
delimited by BEGIN and END; a VARY block nested within block LI; and a 
BEGIN/END block embedded in the VARY block. Note that the two BEGIN 
statements and their associated END statements serve only to group dynamic 
statements in a logical manner; removal of these bracketing statements would 
not alter the processing function of this program segment. 

5.7.2 VARY Block 

A vary operation is used to execute one or more statements zero or more times. 
The statements to be executed are bracketed by a VARY statement and an END 
vary statement. This group of statements is defined as a vary block. The 
number of passes through the loop is controlled by zero or more loop indices, a 
WHILE condition, and/or an UNTIL condition. 
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5.7.2.1 VARY Statement 

The VARY statement initializes the loop and specifies controls for the number of 
passes through the loop (see Figure 5-1). 

Format 

statement-label. VARY index-clause (s) WHILE clause UNTIL clause $ 
Explanation 



Statement Label. 



VARY 

Index-clause(s) 



WHILE clause 



UNTIL clause 



Optional. The name by which the vary block is 
referenced. This label is required if the VARY 
loop is resumed. 

Specifies the start of a vary block. 

Optional. Specifies the data units to be incremented 

or decremented and possibly tested (Paragraph 5. 7. 2. 1. 1 

Multiple index-clauses are separated by commas. 

Optional. Specifies a condition which is to be 
tested before each pass through the loop 
(Paragraph 5. 7. 2. 1. 2). 

Optional. Specifies a condition which is to be 
tested after each pass through the loop 
(Paragraph 5.7.2. 1. 3). 



A program's execution must not depend on incrementing and testing of the indices 
and the evaluation of the UNTIL clause being performed in any predefined order. 
The compiler will order the end loop evaluation according to optimal code 
generation. 
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Simple and compound statements may also be grouped together into blocks by means 
of the brackets BEGIN or VARY and END. Statement blocks are particularly useful, 
and in fact are required, when compounding (nesting) of decision statements is 
desired. 

5.8.1 Statement Blocks 

A statement block is a group of simple or compound statements initiated by a VARY 
or BEGIN statement and terminated by an END statement. A statement block is 
interpreted by the compiler as the equivalent of a simple statement. 



Format 



statement-label. VARY . . . $ 



or 



statement-label. BEGIN $ 



dynamic statements 



END statement-name $ 



Explanation 



Statement-label 



Optional. The name by which the block is identified. 
This label is required on the VARY statement if the 



VARY loop is resumed. 



VARY . 



A VARY statement is specified in paragraph 5. 7. 1. 1. 



BEGIN 



Specifies the start of a block. 



END 



Specifies the end of a block. 



Statement-name 



The name, if any, given to the block as specified 
in the VARY or BEGIN statement. 
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The BEGIN and END statement brackets serve only to delimit statement blocks; the 
BEGIN statement does not specify a dynamic processing function as does the VARY 
statement, described in paragraph 5. 7. 1. Because the BEGIN statement does not 
define a loop structure, it cannot be resumed. Statement blocks delimited by BEGIN 
and END may be nested within, and in the same manner as, VARY blocks. 

Example 

LI. BEGIN $ 

SET A TO B $ 
VARY I WITHIN TAB $ 
BEGIN $ 

SET C TO D**A $ 

IF C LT X00 THEN SET TAB(I) TO C $ 
END $ 

SET A TO A+l $ 
END $ 
END LI $ 

Three statement blocks are defined in the above example: an outer block, LI, 
delimited by BEGIN and END; a VARY block nested within block LI; and a 
BEGIN/END block embedded in the VARY block. Note that the two BEGIN 
statements and their associated END statements serve only to group dynamic 
statements in a logical manner; removal of these bracketing statements would 
not alter the processing function of this program segment. 

5.8.2 Compound Decision Statements 

Because the connector THEN serves a special purpose within decision statements, IF 
statements (and therefore FIND statements) cannot directly appear after THEN or ELSE 
associated with an IF statement. However the compiler interprets all statements within 
a statement block (i. e. , all statements from BEGIN or VARY to the corresponding END 
statement) as the equivalent of a simple statement. This provides a convenient means 
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of compounding, or nesting, IF statements and gives rise to the following 
rule. 

If an IF or FIND statement is to appear following the connector THEN or the 
operator ELSE associated with another IF statement, the nested IF or FIND 
statement must appear within a statement block. (Note that VARY may directly 
follow THEN or ELSE because the VARY statement defines the start of a block. ) 
Furthermore, when a statement block appears within an IF statement, execution of 
all statements within the block is subject to the condition of the IF statement. 

Examples 

1. IF A THEN 

Bl. BEGIN $ 

FIND TAB(I) EQ B $ 

IF DATA FOUND THEN SET F TO 1 $ 
ELSE 

SET F TO $ 
END Bl $ 
ELSE 

B2. BEGIN $ 

IF B LT 10 THEN SET B TO B+l $ 
ELSE 

VARY I WITHIN TAB $ 
SET TAB(I) TO $ 
EN D $ 
END B2 $ 

In this example, the outer decision statement is logically equivalent 
to the form: 

IF A THEN block Bl ELSE block B2 $ 
II-5-62C 



The BEGIN and END statements are necessary due to the nested FIND 
statement in Bl and the nested IF statement (with its nested VARY loop) 
in block B2. 



2. IF STATUS EQ 'START' THEN 
SET STATE TO THEN 
VARY I WITHIN ANS $ 

SET ANS(I,SUM) TO $ 
END THEN 
COMPUTE $ 
ELSE FINISH $ 

In this example, the VARY block is the equivalent of a simple 
statement within the compound conditional portion of the decision 
statement. 
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Index 
Initialization 




False 



Increment Indices 

and Evaluate 
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5. 7. 2. 1. 1 Index Clause . An index clause specifies a data unit which is to 
be initialized before the first pass through the vary loop, incremented or 
decremented after each pass through the loop, and possibly compared against 
a limit after each pass through the loop in order to terminate the loop. 



Format 



loop-index initial -value increment final -value 
Explanation 

The name of the data unit to be varied. 



Loop-Index 
Initial-Value 



Increment 



Optional. FROM followed by a constant, 
arithmetic expression, or data unit that 
specifies the beginning index value of the 
loop. If omitted, the initial value is 0. 

Optional. BY followed by a constant, 
arithmetic expression, or data unit. If 
this value is to be a decrement, BY must 
be followed by a minus sign. If omitted, 
the increment is 1. When varying within 
a table by a negative value, the initial 
value is the number of items defined for 
the table or the major index, and the final 
value is 0. 
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Final Value 



One of the following: 



1. 



May be THRU followed by a constant, 



arithmetic expression or data unit. 
This value signifies the last pass 



through the loop. 



2. 



May be WITHIN followed by the name of 



a horizontal or vertical table, subtable, 



or like-table. The value assigned is 



the number of items defined for the table 



or the current value of the major index. 



The initial -value, increment, and final -value may appear in any order 
within an index-clause. Refer to Paragraph 5. 7. 2. 4 for examples of 
index-clauses. 

5. 7. 2. 1. 2 WHILE Clause. The WHILE clause specifies a condition which 
is to be tested before each pass. If the WHILE condition is true, the pass will 
be executed. 

Format 

WHILE condition 
Explanation 

WHILE Specifies a WHILE clause. 

condition A Boolean condition as defined in Paragraph 5. 6. 1, 

a validity condition as defined in Paragraph 5. 6. 3, 
or a parity condition as defined in Paragraph 5. 6. 4. 

Refer to Paragraph 5. 7. 2. 4 for examples of WHILE clauses. 
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5.7.2.1. 3 UNTIL Clause . The UNTIL clause specifies a condition which is 
to be tested after each pass through the VARY block. If the UNTIL clause is 
true, another pass through the VARY block will not be performed. 

Format 

UNTIL condition 
Explanation 

UNTIL Specifies an UNTIL clause. 

Condition A Boolean condition as defined in Paragraph 5.6, 

a validity condition as defined in Paragraph 5.6.3, 
or a parity condition as defined in Paragraph 5.6.4. 

Refer to Paragraph 5. 7.2.4 for examples of UNTIL clauses. 
5. 7.2.2 Resume (RESUME) Statement 

A RESUME statement specifies a transfer to the increment and test steps within 
a VARY block. This allows partial vary passes through a VARY block and a 
means to continue the VARY block. A RESUME statement may also be used in 
conjunction with a FIND statement, since FIND operations permit VARY operands. 

Format 

RESUME statement-name $ 

Explanation 

RESUME Specifies the RESUME operator. 

Statement Name The name given to the VARY or FIND 

statement to which this RESUME statement 
applies. 
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5. 7. 2. 3 End Vary Statement (END) 

The END vary statement specifies the conclusion of the vary block. If the loop 
is not yet completed, any loop indices are incremented and control is transferred 
to the initial statement within the vary block. If the loop has been completed, 
control is transferred to the statement following the END vary statement. 

Format 

END statement -name $ 
Explanation 

END Specifies the end of a vary block. 

Statement Name The name, if any, given to the corresponding VARY statement. 

5.7.2.4 Examples of VARY Blocks 



1. 



giTif.ftiu, i WAWAMi iRRQM* .1 , ffiHiRIUi ixOs ,i» . . . I 



i i i i i I i i IfiAftDi iSiTiFiPuST I 1^1 i i i i i i I I i i i i i i i i i I 



The data unit APR is varied from starting point 1 (FROM) to the ending 
point 10 (THRU) by an implied factor of ]. The field FCX2 is set to the 
value of 1 INSERT 1 in items 1 through 10 of table PAR. When the loop is 
completed, processing continues with the statement following the END 
st a t ement . 

NOTE 

Upon loop termination (after the END statement), 
the loop index will not necessarily contain the 
value of the ending point or the ending point 
plus one. 
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Mill I I I ISigjTi- iRC^giT.dP^i.). ,T,6« ,01 i»i I I i i i i i I 



I I » 1 I I N IgMftl lSiT|C|Pl6l 1*1 i i I I i I I I 1 I I ] III I I I 1 



•'5. 



The data unit DW is varied according to the number of i terns in table 
FC2RT or the major index (if any). Each word 1 in all items of table 
FC2RT wi 11 be set to 0. 

flttgy.i i i . Vi/?.ft.yi ix. .Rgioh, art. ' i7Wfiim \Q\ ra/i i-di A\ 
111,1.11 Is^m ,y, ,ttq i£k.ri*r*i4i .1 i i 1 i i i i i i i i i 



iTiWiQ^i i i i ki/> t Riy, Z. ,r,/rig|^i igi^ iT^i- i»i . 1 I i ill i I I l 



I 1 I I 1 11 I 



5if|T| irViMiBig i^^a> iTta >yj lil i n n n i 



ii i i ii i I l5|g|Ti t yi i TO i \/y/Z tfi i i nl in mi ii 



i i i i m i l£M2>i fTihiO i A\ 1 i i i i i i i 1 i I i l in I i I I 



i 1 i i i i i i lf>/iDi Prtei ^ I i i i i i. i i i i 1 I i I i I M i i 



This example illustrates nesting of VAKV statements. The vary block 
TWO is restarted after tin,' initialization of vary block ONE and after 
each decrement for vary block ONE. The complete loop is terminated 
after X becomes 0. 

When nesting vary blocks, the END vary block statements must be arranged in 
the reverse order of the vary block definitions. 
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More than one complete vary block can be nested within another vary block. 



5iTiEP.7i.i i l/.4ftyi iC^.Ti/y, In/ftfti/i ^^nCkFig ,Wiy. i3k>, 
M i i ii ii IBi/i di i^i l I i 1 i i i i i i i, i i 1 i i i i i i i i ili 



it ii i i ii 



lSif,Ti l PiAfi,r^.^lr,A ?l C,T^i l > i,"iTT ^ frjjf.a A , I , 



M I l 1 il 



£7<ih , 6rr,r.p,7l A, 



I I I I I I I 1 1 I I 1 I I I I I X 



More lhan one data unit may be varied within a loop. The data unit 
CATB is varied from the starting point (implied) to the ending point 
:U) (THRU) by a factor of 1 (BY) . The data unit CAT A is varied from the 
st art ing point (implied) to the ending point 20 by an -implied factor 
of 1. The field CTR1 is set to the value of CATB in items through 7 
of table FAR. 



NOTE 



If more than one data unit is to be varied, the 
data unit that first satisfies its ending point 
terminates the loop. 
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1 1 1 1 1 I I 
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When C1BR(K,3) is nonzero, t ho statement following l ho IF is no l 
executed. The transfer to make the next pass throuijh the vary block 
is accomplished by the KKSUMK statement. 



,L±j„i.j^L-i-iJsigiii i i rn 6 l i iVi .iti-jii-i-j jj_ ■ .... u.ii..u ui 
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i i I I 1 i 
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' ' ' ' till 



i i i 



i i i till i i 



This example illustrates the transfer outside o i a vary block. When X 
i s fjrea t or t ban 2f» , con t rol i s transferred t o s 1 op LATH out side of t h i s 
vary block. The HhSIIMh' statement will transfer control back into Die 
vary block . 
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8. VARY I FROM I WHILE TAB(I) VALID S 

SET TAB(I) TO TAB(I)+5 $ 
VARY I FROM I WITHIN TAB $ 
SET TAB(I) TO TAB(I)+5 $ 
END $ 

This example illustrates two methods of incrementing a set of table 
items not necessarily starting with the first item. The difference 
between the two methods is the location of the test to determine if 
another pass is to be performed. The VARY using the WHILE clause 
will test before each pass, while the VARY using the WITHIN will 
test after each pass. The WHILE VARY would be used for situations 
in which no passes through the loop were desired because I does 
not contain a valid TAB index. 

9. VARY I UNTIL SYMBOL NOT H(, ) $ 

SCAN $ 

SET NAME (I) TO SYMBOL $ 
SCAN $ 
END $ 

The above example illustrates the use of an UNTIL clause to process 
a comma separated list, storing each list item in a name table 
whose index is also initialized and incremented by the VARY block. 
Assuming SCAN updates the value of the Hollerith variable SYMBOL, 
a test is made at the end of each pass to determine if another list 
item is specified. 
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10. VARY I, J THRU 5 WHILE Bl UNTIL B2 $ 

TABPROC INPUT TIN(I) OUTPUT TOUT(l), Bl, B2 $ 
END $ 

The above examples illustrate a loop which may be terminated by any 
of the three loop termination criteria: index, WHILE, or UNTIL. 
No passes will be made through the block if the Boolean variable Bl 
is false when first entering the block. TABPROC will set the first 
six items of table TOUT assuming neither Boolean variable Bl or B2 
is set to false due to some condition diagnosed by TABPROC. 

11. VARY I $ 

END $ 
VARY $ 

END $ 

The above examples illustrate two methods of programming "infinite" 
loops. The only difference between the loops is that in the first 
example, I will maintain a count of how many times the loop has 
been executed. 

5.7.3 FOR Block 

A FOR block consists of a FOR statement followed by a set of value blocks 
and an END statement which terminates the FOR block. Execution of a FOR 
block will result in the execution of the value block one of whose values is the 
same as the result of the FOR expression contained in the FOR statement. 
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Format 



statement-label. FOR-statement $ 
value-block 



Explanation 
Statement-label 

FOR-statement 

Value-block 

END 

Statement-name 



value -block 

END statement-name $ 

Optional. The name by which the FOR block 
is identified. 

Refer to Paragraph 5. 7 . 3. 1. 

Refer to Paragraph 5. 7 . 3 . 2. 

Specifies the end of the FOR block. 

The name, if any, given to the FOR block 
as specified in the FOR statement. 



Examples 

Refer to Paragraph 5. 7. 3. 3. 

5.7.3.1 FOR Statement 

The FOR statement specifies the controlling expression, type, and optional 
ELSE statement of a FOR block. 

Format 



FOR FOR-expression FOR-type ELSE-statement $ 
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Explanation 

FOR -expression Any arithmetic, Boolean, relational, literal, 

or status expression legal as an assignment 
expression as defined in Paragraphs 5, 4. 1. 1 
through 5. 4. 1. 4. 

FOR-type Optional. The presence of an explicit FOR -type 

is denoted by a comma following the FOR- 
expression. The comma is followed by a 
data type contained in parenthesis. The data 
type may be any type allowed in a variable 
declaration with the restriction of a maximum 
of eight characters for a Hollerith type. If 
the FOR -expression is a variable, field 
reference, typed item reference, or function 
reference and the FOR-type is not explicitly 
specified, the FOR block will have the type 
of the FOR-expression data unit. If the FOR- 
expression is a local or system index and the 
FOR-type is not explicitly specified, the FOR 
block will have a type of I 16 U. If the FOR- 
expression is an item word reference and the 
FOR-type is not explicitly specified, the FOR 
block will have a type of I 32 S. If the FOR- 
expression is not one of the above data units 
the FOR-type must be explicitly specified. If 
the FOR-type is explicitly specified, the FOR- 
expression must agree in type with the FOR-type 
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according to rules of assignment specified in 
Paragraphs 5. 4. 1. 1 through 5. 4. 1. 4. 
Additionally, if the explicit FOR -type is 
Hollerith, the FOR -type may not specify a 
greater number of characters than contained in 
the FOR-expression. 

ELSE-statement Optional. Refer to Paragraph 5. 6. 5. 

Execution of a FOR statement will cause the evaluation of the FOR- 
expression, the required conversion, if any, to the FOR block type, 
and execution of the value block having the same value as the FOR- 
expression. If the value of the FOR-expression does not match any 
of the FOR block values and an ELSE-statement is not specified, 
the control will be transferred to the statement following the FOR 
block. If the value of the FOR-expression does not match any of 
the FOR block values and an ELSE-statement is specified, the 
ELSE-statement will be executed. After execution of the selected 
value block or the ELSE-statement, control will be transferred to 
the statement following the FOR block. 

Execution of a FOR statement is subject to the following rules: 

1. If the FOR-expression is an arithmetic expression, it 
will be evaluated with "simulated receptacle" rules 
defined on Page 1 1-5-4. 

2. The result of a FOR-expression will be converted to the 
FOR block type as if the FOR-expression were being 
assigned to a variable having the FOR block type. 
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3. To produce correct code, the' FOR block type must express 
all possible values which may be produced by the FOR- 
expression. For example, if an arithmetic FOR -expression 
produces a negative value, the FOR block type must be 
signed. This rule does not imply that a value block must be 
specified for each possible value which may be produced by 
the FOR -expression. 

4. To produce optimal code, the FOR block type should express 
only those values which may be produced by the FOR -expression. 
For example, if an arithmetic FOR-expression will always 
produce only the integers between and 7, the FOR block 
should be typed I 3 U. 

5.7.3.2 Value Block 

A value block is a group of statements which is executed when the evaluation 
of the associated FOR-expression results in one of the constant values 
associated with the value block. 

Format 

Statement-label. BEGIN value(s) $ 

dynamic statements 
END statement name $ 



Optional. The name by which the value 
block is identified. 



Explanation 
Statement-label 
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BEGIN Specifies the start of a value block (when 

followed by constants). 

Value(s) Constants that are associated with the value 

block. Multiple values are separated by 
commas. The constant must agree in type 
with the FOR block type. If the constant 
is Hollerith, it will be blank filled to the 
right to the size of the FOR block type. 

Statement-name The name, if any, given to the value block 

as specified on the BEGIN statement. 

5.7.3.3 FOR Block Examples 

1. FOR X $ 

VA. BEGIN 0, 7 $ 

CASEA INPUT H($) $ 
END VA $ 
VB. BEGIN 4 $ 

CASEB INPUT H(, ) $ 
END VB $ 
VC. BEGIN 1,2,3 $ 

SET ERCOD TO 16 $ 
END VC $ 
END $ 

Assuming X is a local-index, the appropriate value block will be 
executed if X has the value 0, 1, 2, 3, 4, or 7. If X is 5, 6 or greater 
than 7, the statement following the FOR block will be executed. If 
it is known that at the time of execution of the FOR statement, X 
will never be greater than 7, the FOR statement should be coded: 
FOR X, (I 3 U) $ 
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2. FBLOCA. FOR F(X)+2, (IA4AS) 

BEGIN -7,-5, 7 $ 
VBLOC. VARY UNTIL X GTEQ $ 

SET X TO X+F(X) $ 
END VBLOC $ 
SET MES TO H( ) $ 
END $ 
BEGIN -1,0,1 $ 
FBLOCB. FOR H(Y) 

ELSE 

SET MES TO H(*****) THEN 

SET X TO 1 $ 
BEGIN H(T1) $ 

SET MSG TO H(AA) $ 

SET X TO 5 $ 

END $ 
BEGIN H(D1),H(T2) $ 

SET MES TO H(??) $ 

SET X TO 7 $ 

END $ 
BEGIN H(D1A) $ 

SET MES TO H(ERROR) $ 

SET X TO $ 

END $ 
END FBLOCB $ 
END $ 
END FBLOCA $ 

The value block containing VBLOC will be executed if the arithmetic 
expression F(X)+2 results in -7,-5, or 7. The value block containing 
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FBLOCB will be executed if the expressions results in -1, 0, or 1, 
If none of these values result, the control will be transferred to 
the statement following block F BLOC A. FBLOCB is a FOR block 
whose FOR-expression is an H 4 type function. If the function 
returns the value H(T1AA), H(D1AA), H(T2A^), or H(D1AA), X 
and IVIES will be set by the appropriate value blocks. Otherwise, 
X and MES will be set by the execution of the FOR ELSE clause. 

FOR T(J) 
ELSE BEGIN $ 
VARY UNTIL T(J) EQ 'FREE' $ 

END $ 
SET T(J) TO 'BUSY' $ 
END $ 
BEGIN »I01' $ 
VARY UNTIL T(J+1) EQ 'FREE' $ 

END $ 
END $ 
BEGIN f I02» $ 
VARY UNTIL T(J+2) EQ 'FREE' $ 

END $ 
END $ 
BEGIN 'FREE' $ 

END $ 
END $ 

Example 3 demonstrates a possible ujsage of a FOR block used to 
control wait loops in a multiprocessing environment where the 
processors communicate the system status through a table with 
status typed items. Note that the value block whose value is 
'FREE' contains no dynamic statements. 



11-5-79/11-5-80 Blank 



M-5035 



SECTION 6 
INPUT/OUTPUT STATEMENTS 



The CMS-2 language includes a number of statements that enable the user's 
program to communicate with peripheral equipment. The operators for these 
statements are summarized below: 



General Operators 
INPUT 
OUTPUT 
FORMAT 
ENCODE 
DECODE 



Special File 
Handling Operators 

FILE 

OPEN 

ENDFILE 

CLOSE 

POS 

FIL 

LENGTH 

DEFID 

CHECKID 



To use these statements successfully, the following restriction must be 
observed: The CMS-2 Monitor must be in core during user-program execution. 
This requirement arises because of Compiler-generated procedure calls to 
input/output run-time routines, which are designed to link with the Monitor 
and communicate with its input/output drivers. 

6.1 INPUT/OUTPUT OPERATIONS 

For many input/output purposes, a user's program requirements can be most 
simply met with only the INPUT, OUTPUT and FORMAT statements. In these 
general situations, the CMS -2 operating system provides system-defined names 
by which the user may reference the hardware device involved with the input or 
output function. These names and their associated devices, hereafter referred 
to as standard files, are described in Table 6-1. 
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TABLE 6-1. CMS -2 OPERATING SYSTEM STANDARD FILES 



FILE NAME 


FILE DEVICE 


READ 


Card reader 


PRINT 


Pri nter 


PUNCH 


Card punch 


OCM 


Operator commu- 




nication medium 



For those cases in which the user wishes to perform input/output operations 
using devices other than standard devices, special file-handling operators 
are provided. These operators are discussed in paragraph 6.3 (Nonstandard 
File Control). 

The INPUT and OUTPUT commands are used to transmit data between a hardware 
device and a user's program. These commands are functionally illustrated in 
Figure 6-1. Each input or output statement causes the Compiler to generate 
calls to particular run-time routines. These routines interface with the 
Monitor to cause immediate transfer of data between a buffer area and the 
hardware device. For standard files/ the run-time routines provide the 
buffer area . 

If formatting (conversion of data from one representation form to another) is 
required, transformation routines that utilize the specifications of the 
FORMAT statement as their inputs are provided. These transformations occur in 
the input/output flow as illustrated in Figure 6-1. Prior to each input or 
output operation, the buffer area associated with that file name is preset to 
blanks if the data is to be formatted, and to zeros if the data does not have 
formatting specified. 

For standard input/output operations where no format statement is prescribed, 
the input card image is interpreted as Hollerith characters and stored with 
the internal octal representation of the individual character. During output, 
the word contents are interpreted in 8-bit Hollerith characters and are printed. 
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User Does Not 
Require Formatting 



External 
Hardware 
Device 



External 
Hardware 
Device 



Output 



Buffer 
Area 



Buffer 
Area 



Data Conversion 
Based on Format 
Statement 







User's 

Data 

Area 



Input 



User's 

Data 

Area 



Figure 6-1. Input/Output Data Flow 
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6.1.1 INPUT Statement 

This statement directs an operation to input data from the device associated 
with the specified file name. When this command is used to transfer data 
into an entire table by means of whole-table referencing, the data is moved 
sequentially word-by-word without regard to the defined table structure; 
however, when all or part of a table is specified by means of item referencing, 
the data transfer is performed by items. If a FORMAT declaration is referenced, 
automatic conversion occurs. 

Format 

INPUT file-name receptacle-data-list format-name $ 
Explanation 

INPUT Specifies an INPUT operation. 

File Name The name of a" standard file or the name of a non- 

standard file that has been defined with a FILE 
declaration statement. Legal standard file names 
for input are: 

1. OCM - specifies the operator communication 
medium. 

2. READ - specifies the operating system's input 
device for punched card images. 

Receptacle Data List One or more of the following CMS-2 data structures. 

If more than one receptacle is to be specified, the 
names, separated by commas, are gathered into a list 
which is enclosed in parentheses. 

1. The name of a table, subtable, like-table or 
item-area. This name indicates that the entire 
structure is to be used. 

2. The name of a major index of a table, subtable or 
like-table. 

The name of a variable;. 
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4. A specific, item reference of a table, suitable, 
or like-table, which may be indexed by a variable 
or a numeric parameter. This indicates that 
every word of this item is to be used. 

5. A field or fields of some specific item within 
a table, subtable, like-table or item-area. 
Multiple field references can be made to any 
item specified; these references must be separa- 
ted by commas. 

6. A series of items of a table, like-table or 
subtable that may be modified by field refer- 
ence(s). This modification is accomplished 

by bracketing the starting item number in paren- 
theses followed by three periods followed by 
the ending item number and bracketed in paren- 
theses, such as: 

HIGHT ((A). ..(B), Ml, M2) 

where Ml and M2 are fields within the table. 

7. A series of items in an array: 
ARRAY ((K,L,M)...(N,P,Q)) 

Every word in the referenced items is filled. 

Optional. Refers to the name of a previously defined 
FORMAT declaration. If a format name is specified, 

the data units in the receptacle data list must have 

internal data attributes compatible with the external 

conversion format type. 
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Examples 



ii i i i i i r it iii i ill 


i i i i i i i i i 


i ii ii ii i i 


i 


ii i ii i i i * 


i i i i i i 1 1 1 


i i i i I i i 1 1 


i i i iiii ii 


I 




i i i i i i i i i 


MM III 1 1 


i 



In this example, one record is read from the device described by the FILE 
declaration LBR and is transferred to fill each word of the table CAB. 



11111111' 


i i i i i i i I i 1 i i i i i i i i i i i i i i i i i i i 


i i i i i i i r n i i i i i i i 


1 1 1 1 1 1 1 II 1 1 II 1 1 1 1 1 1 


hWi*|71 ffiH 


/?,*,£, M^f 2 


)l ^1 1 1 1 1 1 1 1 1 1 1 II 1 II 1 



One record is read from the device described by the FILE declaration IMAGE 
and is transferred, filling each word of item 2 in table DICT. 



\F\Q*\*\*\Ti \F\0rt\d)fi\ i3|X,S| ■ biCi3,)i ^m i i 1 i i i i i i m i 1 



1_L 



iW l i » i 



Ui .Ri iZ0\ ,Af|T,2 



■fr i i I I I i i III 



Ji/>|B,i,E, ,MlJ|Q|* 
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£,Mri7T/M?,t[r, ,* 
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I i I I I i i i i i i I i i 



W*! I *i I I i i 



i i i i i i i 



I I I I I I I I I I I 



I I I I I I I I I I 



I I I I I I I I I I I I I I 1 



I I I I I M I'l I I 



I I I I I I 1 I I I 



I I I I 1 I I I I I I I I I 1 I 



t\Mfr VV\ \i A P\ Wl///l0l*l(l(lOl)l»l*l' 



I I I I 



One record is read from the device MT2; assume that it is the Hollerith 
string: * 

U A 350A A 201A A A A 1777 A A (20 characters) 

When the format FORMA is applied to this string; -the results in memory 
are: 



MINOR (0,0) 350 

MINOR (1,0) 201 

MINOR (2,0) 

MINOR (3,0) 777 



10 



10 



10 



8 
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6.1.2 OUTPUT Statement 



The OUTPUT statement directs an operation to output data to the device 
associated with the file name. Data transferred from an entire table by an 
OUTPUT command using whole-table referencing is moved sequentially word-by- 
word without regard to the defined table structure. However, when all or 
part of a table is specified using item referencing, the data transfer is 
performed by items. If a FORMAT declaration is referenced, automatic conversion 
takes place. 

Format 

OUTPUT file-name source-data-list format-name $ 
Explanation 



OUTPUT 
File Name 



Source Data List 



Format Name 



Specifies an OUTPUT operation. 

The name of a FILE declaration or a standard file. 
Legal standard files for OUTPUT are: 

OCM Operator communication medium. 
PRINT Systems output for printer listing. 
PUNCH Systems output for card punching. 

A constant or one or more of the operands as 
described for the INPUT statement. If the FORMAT 
declaration describes a Hollerith string only, the 
source data parameter is not required. If more than 
one data unit is to be acted upon, the names are 
gathered into a list, separated by commas and 
enclosed in parentheses. 

Optional. An operand referring to a previously 
defined FORMAT declaration. If a format name is 
is specified, the data units in the source data 
list must have internal data attributes compatible 
with the external conversion format type. 
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Examples 

1. fltf.T.P.U.T, .plftJ.MT, .PX .C.T. \T£\kxkxYx \ti i i 1 i i i i m m i l 

The data to be written on the device identified in the file named PRINT 
is contained in the variable DICT. The optional operand TERRY, refers 
to a previously defined FORMAT declaration. 

The data contained in the tables POS, SPEED, and ID is to be written on 
the device identified in the file named DATUM. The optional operator 
TRUNC refers to a previously defined FORMAT declaration. 

3. In reference to the data structure of Example 3, paragraph 6.1.1, assume 
that table MAJOR is the result of the INPUT command. 

■\aomP*\T\ i/Uft* )Mj\rt£>\£i(\t\0\}\*\*\*\(\3\)\\\ \f\Q\&M*\ l/l I l I II I 

The values in MINOR (0,0) through MINOR (3,0) are transformed to the 
Hollerith character string: 

A A 350 A A 201 A A A A 1777 A A (20 characters) 

which is then transferred as one record to the hardware device MT2. 

6.1.3 FORMAT Declaration 

The FORMAT declaration describes the conversion of data between internal and 
external forms. The external form is usually a Hollerith string containing, 
in addition to the data, certain spacing and control information. Data 
existing in this external form is referred to as formatted data and is 
transmitted to and from an external device in this form. 

When the user requires data conversion, he references the FORMAT declarative's 
name in the INPUT or OUTPUT command. The FORMAT declaration is always referenced 
by the ENCODE and DECODE statements when they are utilized in a program. FORMAT 
declarations may appear only in data designs. 
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'orma t 



,Q„ $ 



KOKMAT name Q t Q. )t Q <r . . 
Explana t ion 

FORMAT Specifies the FORMAT DECLARATION. 

Name The identifier to be used to reference this FORMAT declara 

t ion. 



A format descriptor. The format descriptors indicate the 
form and arrangement of data and the types of conversions 
to be performed. 



Numeric conversion types are summarized below, 



Internal Form 

Fixed-point binary 
Floating-point binary 
Floating-point binary 
Fixed-point binary 



Format Descriptor 

Iw.d 
Fw.d 
Ew. d 
Ow.d 



External Form 

Fixed-point decimal 
Fixed-point decimal 
Floating-point decimal 
Fixed-point octal 



In the list of format descriptors; that follows, w is an unsigned integer 
representing the maximum width (number of characters) of the field in the 
external medium. Integer w must not exceed the number of characters in one 
printer line. Descriptor d is an unsigned integer representing the number of 
characters in the field that appears to the right of the binary or decimal 
point. The maximum width of the field w must include space for signs, radix 
points, and exponent descriptions. Hence, field d must be less than w. The 
d-field is optional if the internal fixed-point binary value is an integer. 
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Format Descriptor 
Iw. d 



Fw.d 



Ew.d 



Function 

Specifies conversion of data between 
internal fixed-point binary and an 
external fixed-point decimal Hollerith 
character string. For a positive value, 
w > d+2. For a negative value, w 2. d+3. 

Specifies conversion of data between 
internal floating-point binary and 
external fixed-point decimal. For a 
positive value, w^. d+2. For a negative 
value w > d+3. 

Specifies conversion of data between 
internal floating-point binary and 
external floating-point decimal. 

The acceptable forms of input fields 
for the E conversion (floating-point) are: 

+0. mantissa E 

+0. mantissa E + exponent 
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The mantissa may be of any magnitude; 
the allowable exponent range depends 
upon the object machine. The output 
form for E conversion is: 

+0 . xxx . . . xxxE+ee 

where: 

d is the number of digits in 
the mantissa, w includes all 
characters. Thus, w £ 7, where 
the 7 accounts for the specific 
characters +O.E+ee of the above 
output form. 

Ow.d Specifies the conversion of data 

between internal fixed-point binary 
and external fixed-point octal. For 
a positive value, w must be ^ 2. For a 
negative value, w must be ^ 3. 

Other formats descriptors that may appear are described below. 

Format Descriptor Function 

H (string of characters) Specifies an alphanumeric field in the 

form H(ABC), for example, where ABC 
represents a string. For input, an H 
(string) specification causes n char- 
acters to be skipped in the input record. 
For output, the string of characters 
specified within the parentheses is the 
output image. j 

Aw Specifies the first w characters of an 

alphanumeric data unit in a transfer to 
or from an input /out put buffer. Aw appears 
in the FORMAT declaration. The related 



II-6-11 



M-5035 



Format Descriptor 



Lw 



wX 



Tw 



n format descriptor 



Function 

data unit in the input/output reference 
can have more than w characters. The 
remaining characters are ignored. If 
the data unit has less than w characters, 
the rightmost characters are truncated 
on input and trailing spaces are inserted 
on output. 

Specifies the same as Aw, only here the 
last w characters of the data unit are 
used. Everything else said under Aw 
applies here. 

Specifies skip w characters of an input 
record or insert w spaces in an output 
record. 

Specifies a position designator for the 
buffer of a record input/output file, w 
indicates the character position within 
the buffer. The count starts with at 
the start of the buffer. The FORMAT 
statement can have many T's, one for every 
data word or constant. T is illegal 
for files having a length descriptor of S. 

Specifies repetition of a format descrip- 
ter n times, such as n Ew.d. 

Slash specifies end of a record or, when 
used sequentially, indicates the number 
of records to be skipped or inserted: 
n+1 consecutive slashes on input cause 
n records to be skipped, n+1 consecutive 
slashes on output cause n blank records 
to be produced. 
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Format Descriptor 
m(group of descriptors) 



Printer carriage 
control characters 



Format 

Specifies the repetition of a group of 
format descriptors within the parentheses 
m times. No other parentheses except for 
H descriptors are allowed within the group 
of descriptors. 

Appear in an H string. They specify 
spacing, page eject, etc. These control 
characters appear as the first Hollerith 
character in the first word of each 
record. If the character is not one of the 
following, it is replaced with a blank. 



Carriage-Control 
Character 

blank 







H 



B 



Operation 

Single space and print 
line. 

Double space and print 
line. 

Triple space and print 
line. 

Page eject and print 
line. 

Cancel headers, page 
eject and print line. 

Cancel headers t page 
eject, print line and 
save location and length 
of line as a major header, 

Cancel lower-level 
headers, double space, 
print line and save 
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Carriage-Control 

Character Operation 

location and length of 
line as a minor header. 

C Cancel lower-level 

headers, single space, 
print line and save 
location and length of 
line as a minor header. 

If classification, major header, and/or minor header lines are wanted, they 
will be printed in the following order each time a page eject is necessary: 
classification/major header with page number, minor header B, minor header C. 
The page number will occur even if a major header is not used. It is not 
necessary to specify consecutive levels of minor header information. 

It is the programmer's responsibility to ensure that the specified type of 
format conversion is compatible with the declared data unit mode (for example, 
F-type conversion should not be applied to integer data units). If the FORMAT 
descriptors are exhausted and the target list not yet filled, the FORMAT is 
restarted. 

Examples 

1. Given the external string of characters 
350274-0162E+O50703 with format 

ifiOi*i*i'iri ck>irt£i i49m*Ui i iOiii'iQ| i iti . 

the quantities stored on a read or decode statements are: 
35, 27.4, -1.62X10 5 , 703 
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2. Given the internal quantities 
417, -320, 0.536xl0 3 and octal 627 
with format 

ffg.K.M.^r, 3>IM,B, |r,i,. A,,^,,;,,^!,,^, , ,o^l.,o, ,f 

the string of characters resulting from an OUTPUT or ENCODE 
statement is : 

1417***#**#+0. 536E-K)3^>27 

where the asterisks indicate that the value -320 cannot be encoded 
within an F6.2 format descriptor. 

3. Given the internal quantities 
27, H(XYZ), 74.51, H(JKLM) 
with the format 



■ * iiiii 



the string of characters resulting from an OUTPUT or ENCODE 
statement is: 
27.00RAGYZ 74.51M0DPJK 

6.2 ENCODE AND DECODE OPERATIONS 

The ENCODE and DECODE statements direct run-time routines to transfer data 
internally from one area of the computer to another, while converting the data 
from nonformatted to formatted (encoding) or vice versa (decoding). The 
transformation is specified by a FORMAT declaration. 

The ENCODE and DECODE statements are analogous to INPUT and OUTPUT statements 
that reference a FORMAT declarative, except that no transmission to an I/O 
device takes place, and the buffer area involved is a data unit specified by the 
programmer. ( The rules previously discussed regarding formatted I/O also 
apply to the decode/encode operations. 
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When inputting records of different types, a DECODE statement can be used to 
reformat the data after the record type has been examined. The ENCODE state- 
ment can be used to format data that is to be modified before being output. 
These statements are also valuable for debugging by simulating input/output 
operations in memory. 

The ENCODE statement specifies that the data contained in the data units 
named in the source list is to be converted as specified in the named format 
declaration and packed into a character string identified by the formatted 
data-unit name. 

The DECODE statement specifies that the character string identified by the 
formatted data-unit name is to be converted as specified in the named format 
declaration and placed in the data units named in the target list. 

Format 

ENCODE formatted -data -target unformatted-source-list 
format -name $ 

DECODE formatted-data-source unformatted-target-list 
format -name $ 

Explanation 

ENCODE Specifies the encoding operation of 

converting data from unformatted to 
formatted form. 

DECODE Specifies the decoding operation of 

converting data from formatted to 
unformatted form. 

Formatted Data Target The data-unit name that will receive the formatted 

character string (starting in character position 0). 
This identifier may refer to a single word or 
multiword data unit with Hollerith attributes. 
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Formatted Data Source The data-unit name containing the 

character string (starting in character 
position 0) to be converted to 
unformatted data. This identifier may 
refer to a single word or a multiword 
data unit with Hollerith attributes. 

Unformatted Source List One or more data units containing the 

data to be converted to character string 
form. If more than one data unit are 
specified, they are collected together, 
separated by commas, and enclosed in 
parentheses. These data units must have 
internal data type attributes compatible 
with the external conversion format type. 

Unformatted Target List One or more data units that will receive 

the unformatted data after conversion. 
If more than one data unit is specified, 
they are collected together, separated by 
commas, and enclosed in parentheses . These 
data units must have internal data type 
attributes compatible with the external con- 
version format type. 

Format Name The identifier of the format. 
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Example 
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I I I I I I I I l 



In this example, the character string JOE is to be packed with the 
value of VRBLsAl, A2 and A3 as indicated by the format BILL. The 
result will be 



JOE: 223G0BAC12.14 



6.3. NONSTANDARD FILE CONTROL 

The special file operators presented in the remainder of this section are not 
to be used with the standard file names listed in Table 6-1. 

In addition to the CMS -2 operating system standard file names and their 
associated devices, each operating system provides other devices for the user. 
These devices consist principally of magnetic tape and paper tape punch units. 

The principal difference in using nonstandard devices versus standard devices 
is the requirement for the user to describe the physical characteristics of 
the data to be transferred and to state the name of the device on which input/ 
output operations are to occur. These attributes are collected in a formal 
declarative called a FILE declaration and identified by a user-supplied file 
name. This file name has significance only within the user's program. It 
provides the linkage between the attributes described in the file declarative 

statement and the run-time routines that interface with the Monitor to achieve 

satisfactory input/output results. 
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The following definitions are necessary before proceeding with the discussion 
of nonstandard file control. 

Logical record A group of adjacent, related data 

items such as the individual erif ties 
in a telephone book for name, address 
and telephone number. This organization 
has significance only to the user and 
is not necessarily a physically definable 
entity. 

Physical record A group of adjacent, related logical 

records defined as a unit such as the 
alphabetic groupings of telephone 
book entries. On magnetic tape, a 
physical record is delimited at the 
beginning and end by inter-record gaps. 
These gaps are recognizable by the 
hardware device. A physical record 
may contain one (unblocked) or mo»" 
than one (blocked) logical records. 
Blocking is the technique used to reduce 
the wasted space of inter-record gaps 
between unblocked logical records. 

Physical file A group of adjacent, related, physical 

records defined as a unit such as the 
complete telephone book for one city. 
On magnetic tape, a physical file is 
delimited at the beginning and end by 
an end-of-file mark (for the first 
physical file of a tape, it's beginning 
is signified by a beginning-of-tape 
mark). These marks are recognizable 
by the hardware handling device. Thus, 
the physical file comprises one or more 
physical records. 
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Peripheral file device 



That mechanical device which is the repository 
for a group of adjacent, not necessarily 
related, physical files. A file device may 
contain one or more physical files as space 
per mi t s . 

A unique, user-assigned name to provide 
referencing from the dynamic input/output 



File-name 



command and control statements to the 



run-time routines. 



6.3.1 FILE Declaration 

This declaration is mandatory for all input/output functions involving non- 
standard file devices. 

The FILE declaration defines the environment in which one or more physical files 
are to be processed. The declaration assigns a file name for dynamic statement 
referencing, identifies the symbolic name assigned to the actual hardware 
device, and declares that all data to be processed on the named hardward device 
is physically organized as described in the declarative statement. 

The FILE declaration indicates the hardware device and reserves two areas. 
The first area contains the record description, the file status variable, device 
address, space for keeping track of file and record positions, and in case of a 
file having the length descriptor S, the position pointers. The second area 
reserved is a buffer, equal in size to the maximum record that may be trans- 
mitted. For record input/output the buffer area does not accumulate data for 
blocking purposes, so that each INPUT or OUTPUT statement causes immediate 
communication with the device. If the file declaration contains the length 
descriptor S, data is accumulated in a fixed size stream buffer and output is 
under control of run-time routines. 

The number of words transferred between the buffer and the data area depends 
upon the number of words specified in the data list of the input or output 
statement rather than the record length. For example, if 50 words of input 
are requested by specifying a 50 -word table in an input statement and if the 
input record is only 10 words long, the first JO words of the input record are 
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assigned to the first 10 words of the table, and the remainder of the table is 
Set to blanks or depending on the record type. If 50 words of input are 
requested and the input record is 100 words long, the first 50 words of the 
input record would be transferred and the remaining 50 words would be lost. 

The INPUT and OUTPUT statements, when referencing a FORMAT declarative, imply 
either an automatic decode from the FILE declaration buffer area or an auto- 
matic encode into the FILE declaration buffer area. 

The FILE declaration must occur in one of the user's data design areas. A hard- 
ware device may be referenced in more than one FILE declaration. Standard 
hardware units have implied FILE declarations; the user is not required to 
declare them. 



Format 



FILE file-name type maximum-no ,-of-records 
length-descriptor maximum-record-si ze 

hardware-name states WITHLBL $ 



Explanation 



FILE 



Specifies a FILE declarative. 



File Name 



An identifier to be used to reference this 



information. 



Type 



One of the following: 



H - records are all Hollerith. 



B - records are all binary. 



Maximum Number of Records An integer or tag that specifies the maximum 



number of records that may be accessed in 
a physical file. If is specified, any 
number of records may be accessed. 



Length Descriptor 



One of the following: 



R - the size of each record is equal to the 
maximum length as defined by the record size 
(rigid length) . 
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V - The size of each record is determined by 
the amount of data transferred to and from the 
file buffer and is not to exceed the maximum 
length as defined by the record size (variable 
length) . 

S - The size of each record is rigid. Data is 
accumulated in the buffer gradually. 

Maximum Record Size An integer or tag that specifies the maximum 

length of the record (meaning number of words 
if the type is B and number of characters if 
the type is H). If is specified, the size of 
the operand used in the particular input/output 
statement determines the record length. In 
this case, no buffer area is set aside, and 
data is transferred directly between the data 
area and the input/output device. Zero is 
illegal with a length descriptor of S. 

Hardware Name The name of any external storage device in a 

computer's environment. Run-time routines will 
provide direct interface with peripheral 
equipment (printer, punch, magnetic tapes, etc.). 
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States 



WITHLBL 



Examples of hardware names, which may vary 
for each installation: 

MT2 Magnetic tape input and output units. 

TTY Teletype. 

An optional parameter that defines one or 
more states, which may be tested between 
input/output operations on this device. Each 
state is a mnemonic enclosed in single primes 
and corresponds to one of the numeric values 
returned by the Monitor after each I/O 
operation. (See paragraph 2.3.1.4 Volume I). 
Testing one or more of these states may be 
necessary to avoid an input/output abort 
(see paragraph 6.4 for format to test states) 

Optional. Indicates that this file has or 
will have a label for identification as its 
first entry preceding the first record. 



Examples 



, . i i i i i i i I ^.ftfiOiftiMfl.L/n, 1 1 igiQifi / if i > x igi/^l/?i / . \fi i i in 



The file LBR has a maximum of 3200 Hollerith-type records, whose 
sizes are rigid (120 characters). The external storage device named 
is MT2, whose possible states are ' BUSY ' , 'NORMAL', 'EOF', and 'ERR'. 



i i i i iii I i \'\£Q\n '\ t \tf/\r[d6\A£j ift 



The file OBJC is a binary file containing up to 700 records with 
the name OBJC as the first record. The record size is variable and 
may have a maximum of 480 words. If the user tests an 'EOF* hardware 
state. Monitor hardware state-2 will be tested. 
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6.3.2 OPEN Statement 

Before data can be transmitted between a user's program and an external non- 
standard device by means of the INPUT or OUTPUT statements, the run-time 
routines must be informed that any reference using the FILE declaration name 
is legitimate and expected. The OPEN command instructs the hardware device 
specified by the FILE declaration to be accessible for input, output or both. 

Execution of an OPEN statement does not establish or guarantee the physical 
readiness of the hardware device. In addition, a file that is open may not be 
reopened until it has first been closed. That is, if a file is to be changed 
from an input unit to a scratch unit, it must be closed and reopened as a 
scratch unit . 

Format 

OPEN file-name action $ 
Explanation 

OPEN Specifies an OPEN operation. 

File Name The identifier of the file. 

Action One of the following: 

INPUT 
OUTPUT 

SCRATCH (both input and output allowed) 

Example 

\O R€ M \LBM \i) M f W\r\ 4 \ \ l 1 M i il I I III I III Ml l 1 1 i 

This statement causes the file identified as LBR to be activated 
and specifies use as INPUT only. 

6.3.3 ENUFILE Statement 

if a user wishes to group records together, he may form a physical file. A 
physical file of data is any set of sequential physical records delimited by 
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an end-of-file mark. These groupings may be used for device positioning; a 
device may contain any number of these marks. 

The ENDFILE statement is used to place an end-of-file mark on those hardware 
devices to which it is applicable. Writing an end-of-file automatically sets 
to the record count associated with the file name of the file declarative. 
There is no change in the physical position of the hardware device as a result 
of this command. 

Format 

ENDFILE file-name $ 

Explanation 

ENDFILE Produces an end-of-file mark on a 
hardware device. 

File Name The name of a previously opened 
nonstandard file. The parameter 
OUTPUT or SCRATCH must be included 
in the OPEN operation for this 
file name. 

Example 



1 1 1 1 1 1 1 1 1 
* 111 til 11 


i i*i i i i i i i 
i i*i i i i i .i i 


1 1 1 1 1 1 1 1 1 
1 1 1 1 1 1 1 1 1 


1 1 1 1 1 1 1 ( 1 1 1 

I 1 1 ! I 1 1 I 1 II 


1 1 1 1 1 1 1 1 1 


i i*i i i i i i i 


1 J 111 1 III 1 1 1 1 1 1 1 1 1 


1 1 


0\Pi€\M \LJkSL. 




1 1 1 1 1 1 1 1 1 


1 1 1 I 1 1 1 1 1 


1 1 


i j i ) i i i ii 


i i*i i iii i i 


1 1 1 1 1 1 1 1 1 


1 1 l i I til I 


1 1 


1 1 1 1 Ml 1 1 


i i»i i iii i i 


1 I 1 1 1 1 1 1 1 


t 1*11 111 1 II 


1 1 1 1 1 1 1 1 1 


1 !•! 1 1 1 1 1 1 


1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 II 




i4i i i i i i i i i i i i i i i 


| I I 1 1 III 1 1 1 



'i.i/.y.ftM', 



The file declaration LBR, specifying hardware device MT2 , is opened 
for both input and output. The ENDFILE operation causes an end-of- 
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file mark to be placed on the hardware device MT2 , the record count 
for LBR is set to 0, and the file count is incremented by one. 

6.3.4 CLOSE Statement 

The CLOSE operation deactivates the specified file by setting an indicator 
that this file is not activated. Standard devices cannot be closed. Closing 
an output file having a length descriptor of S will also send the last un- 
finished buffer to output. 

Closing a tape file does not imply rewinding the tape. A SET FIL (file) to 
or -0 will rewind the tape. Setting to -0 will rewind the tape, release the 
device, and close the file (see paragraph 6.5.1). 

Format 

CLOSE file-name $ 

Explanation 

CLOSE Specifies a CLOSE operation. 

File Name The identifier of the file. 
Example 

idt\OiSi€\- \C\AA ift i i i i i i i I i i i i i i ) i i 1 i l i i I I 1 I I I i i 

This statement causes the file identifier as LBR to be deactivated. 
6.4 DEVICE STATE CHECKING 

In performing any input/output, various states may be flagged by the Monitor. 
These states might indicate such errors as end of input conditions either as 
a hardware problem or system problem. 

Each device may have various associated states that may be checked by the user. 
Those states which are of interest to the user may be specified in the FILE 
declaration by unique mnemonics enclosed in single primes. 
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The states may be tested by use ot the IF statement containing the file name 

and this unique mnemonic. The test checks equality between the current status 

of the file and the value assigned to the unique mnemonic. All runtime I/O 
operations are completed before returning to user's program. 

It should be noted that this test is dependent upon the hardware and Monitor 
system. The list of states appearing in the FILE declaration must correspond 
to the numeric status values returned by the Monitor (see Volume I). 



Format 



THEN expression $ 



IF file-name EQ or NOT state 
Explanation 

IF Specifies an IF statement. 

File Name The name of a FILE declaration. , 

EQ or NOT Specified relational operators. , 

State Any mnemonic designated in the FILE 

declaration. It must be enclosed in single 
primes. 

THEN A CMS -2 connector word. 

Expression Any CMS-2 dynamic statement. 
Examples 



i. fiFi /iV^M/i 1^*1 ftOjTfl if^Wofl », , 

The status variable of the FILE LBR is tested. 

If the condition indicated by the mnemonic 'NRM' is true, a 
transfer to ENJOB is executed. 
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I 111 II I I 



I I I 



I I I 



I I I 



I I I II 



I I I I I I I I 



J I I I I I I I I 



I I III 1 I I I I I III I I I I I 



II I I II II 



'I III I I » 



II III I III 



I I I I I II II 



AP,f,v, , /,*/|r,c, , 'AW, ,*\ 



I I I I I I I I I 



I I I I I 



W,r, jtWXfi, A'SPfi, \i 



ill i I i I'' 



I I I I I I I I I 



The state for 'EOF* (Monitor hardware status code 2) in the file 
defined by INPTC is tested. If the condition is true, a transfer 
to ALPHA is executed. 

6.5 DEVICE POSITIONING 

In order to retrieve data from a device more efficiently, the programmer may 
separate his data into one or more files or subfiles. The run-time routines 
will recognize these files by end-of-file marks and maintain position counters 
for the number of files passed and a counter for the number of records passed 
within a given file. 

The SET statement in conjunction with the functional modifiers POS (record 
position), FIL (file position) and LENGTH may be used to physically position 
a device, determine its present position or determine the length of a record. 

Positioning requests are not applicable to all devices and incorrect use of the 
above modifiers will result in an input/output error indication. 

6.5.1 Positioning By Files 

A unit may be positioned forward or backward by a number of files or subfiles. 
The unit is always automatically positioned following the eid-of-file mark. 

Format 

SET FIL(name) TO signed-integer-constant or data-unit-name $ 
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Explanation 

SET Specifies a SET operation. 

FIL(name) Specifies the positioning (FIL) of the unit 

specified by the name of a FILE declaration. 

TO CMS-2 separator. 

Signed Integer Constant Specifies the number of files the unit is to be 
or Data-Unit Name positioned. The sign indicates the direction 

of the movement: + forward and - backward. If 
a data name is used, it must contain an integer. 
A data-unit name containing a will cause the 
device to be positioned to the beginning, If 
-0 is specified, the unit is locked out from 
further reference. 

Examples 

1. filElt, ifi/|*lrt*|A|K|f|<-|A|fti)MTl», |i-P|C|l| i»l I ! I I I I | M I I I , 

If the variable LOCI contains a 4, the device referenced in file 
declaration NARFLAG will be positioned forward four file marks. 
The same statement may be used to backspace four files by setting 
LOCI to -4. If a request is given to backspace more files than are 
written on the device, the device is positioned at the beginning. 
A request to backspace one file mark causes the tape to be positioned 
at the start of the current file. 
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2. ^i/|t,r, /ijr.FlJ, ,3,0,0, ,R, ,1,*!*, ,/H.T 
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1 1 1 1 1 1 1 1 * 1 1 1 1 1 1 1 1 1 


I 1 1 1 1 1 1 1 1 I I Ml 1 1 1 1 1 < 






i^i f4 i i ii i i 


ill, 


1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I 


i I i 1 I i 1 1 1 1 1 1 1 1 1 1 I 1 i 


<iAiMiMiAi»i i ^.E.n.Rm^T 






fi c i IV 1 1 1 1 i 


1 II i 



Statement ALPHA causes the hardware device MT13 to be positioned 
forward as many files as indicated in the variable FILPOS. Statement 
BETA causes the hardware device WT13 to be set to the beginning 
position 0.' By statement GAMMA, the hardware device is set to the 
beginning, locked out from further reference, and the FILE MTF3 is 
«losed. Each time, the file counter is adjusted. 

6.5.2 Positioning by Records 

A unit may be positioned forward or backward a number of records within the 
current file. Attempted record positioning beyond the bounds of the current 
file will cause the device to be positioned at the beginning or end of the 
current file. Record positioning should not be used with stream files. 

Format 

SET POS(name) TO signed-integer-constant or data-unit -name $ 
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Explanation 

SET 

POS 

TO 

Signed Integer Constant 
or Data-Unit Name 



Specifies a SET operation. 

Specifies the positioning (POS) of the unit 
named by a FILE declaration. 

CMS-2 separator. 

Specifies the number of records to be forward 
or backward spaced. 



Examples 

i. frdTi iPASiQgAQiKi), J10| iS|c,R,f,f,A/| | , | | | | , , , | , , | , 

In this example, the file named BOOK is spaced forward the number 
of record positions contained in the variable named SCREEN. 



2. 



in r rri mn* 

1 1 1 1 ! 1 1 1 


i i i i i 


ioi i*i iki nn 111 1 

i I I 1 1 1 1 1 1 1 1 1 1 1 


101*1 \i\ j*^n i 
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i i i i i i i i • 


i i i i i 
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II 1 1 1 III 1 


.. 1 


ofSMv i/Mi&f.'.L.e.*, 


,/MP.ulT, i, , , . i i . 


1 1 1 1 I 1 1 1 1 


1 


1 I I 1 II 1 L 


Mill 


i i i i ii i i i ii i j 


1 1 1 1 1 1 1 I I 


1 


S,e,7, .Pp.s.Y 




«■,■*). Ita r,3, M , , 


1 1 1 1 1 1 1 1 1 


1 



The hardware device described as WT4 is positioned three records 
backwards, relative to its current position. 



6.6 FILE AND RECORD POSITION DETERMINATION 

The record file or subfile position within the current file can be determined 
with the use of the POS or FIL modifiers. 

Format 

SET data-unit-name TO FIL(name) or POS (name) $ 
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Explanation 

SET Specifies a SET operation. 

Data Unit Name The location where record position is to be stored. 

TO CMS-2 separator. 

FIL(name) or POS(name) Specifies the file position (FIL) or record 

position (POS) of the unit specified by the name 
of a FILE declaration. 

Example 





. iWi i*. « 1 i 


1 1 1 1 1 1 1 1 1 1 
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\ F \'f\(\ L \*\*,)\ 1*1 II 1 I 
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?l*Fl l L .*l«l Po rS| .Tift 




1 I 1 1 1 1 1 1 1 



The current file or subfile position of the hardware device MT2 is 
stored in the data unit LBRFIL; the current record position within 
this file is stored in LBRPOS. 

6.7 RECORD LENGTH DETERMINATION 

The length of the last record transmitted by either an INPUT or an OUTPUT 
statement may be determined by using the functional modifier, LENGTH. 

Format 

SET data-unit-name TO LENGTH (name) $ 
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Explanation 
SET 

Data-Unit Name 
TO 

LENGTH (name) 



Specifies a SET operation. 

Specifies the location where the record length 
is to be stored. 

CMS-2 separator. 

Specifies the length of the previous record on 
the unit specified by the name of a FILE 
declaration. 



Example 







i i I i l 1 i i i 


I 


1 1 1 1 1 !' 1 1 1 ! 1 1 1 1 1 1 1 1 1 II 1 II 1 


1 1 I 1 1 1 II 1 i 







8 DEVICE IDENTIFICATION OPERATIONS 

is sometimes desirable to make a check on a device (e.g., a tape unit or 
sk to make sure that the right unit is mounted). The following two special 
:atements are used for this purpose: 

1. DEFID Statement. 

2. CHECKID Statement. 

lese commands are illegal on standard hardware devices. 

.8.1 DEFID Statement 

EFID writes an identifier on an external device. If the tape is not at load 
oint when the DEFID command is given, the statement will be ignored. 

Format 

DEFID file-name STANDARD or (header description) $ 
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Explanation 

DEFID Specifies a CMS-2 control word. 

File Name The identifier of a file that 

references the external device for 
which an ID block is desired. 

STANDARD or Header Description The description of the identifier 

record to be written. If it is 
standard, the header is written in 
the local convention known to the 
run-time input/output routine. If 
a header description is given in 
parentheses, the contents of the 
parentheses are used as header. All 
header records are a standard 30 
words long. 

Examples 

1. J>,E|F^a iliPIRi iS.r^iA/JMiRiDI if i i i i i i i i I i i i i I , 

A standard header will be written on the device referenced in the 
file declaration LPR. 

2. 3><g|Wi itiPft. \(\hW{i»^om .S^.Eftq 11, ,31(4,1, t UiY |$, 



The header "INVENTORY SDIEGO 1 JUL 71" will be written on the device 
referenced in the file declaration LPR. 
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6.0.2 CHECKID Statement 

CHECKID checks an identifier on an external device. If the tape is not at 
load point when the CHECKID command is given, the statement will be ignored. 
Failing the check will result in an input/output error condition. 

Format 

CHECKID file-name STANDARD or (header description) $ 
Explanation 

CHECKID Specifies a CMS-2 control word. 

File Name The identifier of a file which refer- 

ences the external device on which the 
identifier is to be checked. 

STANDARD or Header Description Describes the wording against which 

the identifier is to be checked. 

Example 

iC\H-\£\ c \K x i)\ iS|Ti>WMI*>Pi 1^1 i i i i i I i i i i i i i i i I i 

The header record on the device referenced in the file declaration 
LPR will be checked if it is in standard format. 
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SECTION 7 
COMPILE-TIME SYSTEM FACILITIES 

The primary function of the CMS-2 Compiler is the translation of source state- 
ments into machine (object) code. To effect this translation, certain conven- 
tions regarding the organization of the source statements have been established 
in previous sections. These conventions pertain to system data designs and 
system procedures as the organizational elements of a system. In the following 
sections, the header controls of a system are presented. They contain informa- 
tion specifying listing options, loading controls, system index registers, 
inclusion of program debug features in the object code or other facilities that 
effect the compile operation. 

A compile-time system comprises system elements and associated header controls 
(see figure 7-1). This concept establishes a method for obtaining a complete 
or partial translation of a user's program. The compile-time also signals 
the initiation and the termination of the translation process. For translation 
purposes, such a system is regarded as something complete in itself; all infor- 
mation necessary for a successful compile is specified within the system and in 
accordance with the rules and facilities of the CMS-2 language. 

7.1 ACCESSING THE COMPILER 

To obtain the services of the Compiler requires use of a uniquely formatted 
Monitor control card. Furthermore, additional Monitor control cards are re- 
quired to properly define the user's job processing requirements for the 
Monitor. These requirements might be one or more of the following: compile; 
load and execute; build a library; update a library; etc. 

The $CMS-2 Monitor control card activates the CMS-2 Compiler. Following this 
Monitor control card are one or more compile-time systems (source input to the 
compiler). Use of the Compiler is terminated by the CMS-2 statement: TER- 
MINATE $. 

The card formats of the Monitor control cards, their functions and their 
placement in a job deck are discussed in Volume I. 
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Figure 7-1. Elements of a Compile-Time System 
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7.2 MAJOR AND MINOR HEADERS 

Headers are classified as major or minor depending upon position and range of 
influence within a compile-time system. A major header consists of those 
statements immediately following the SYSTEM statement (see paragraph 4.1.1) and 
bracketed by the statement: 

Format 

END-HEAD name $ 

Explanation 

END-HEAD Specifies the end of the header. 

Name Optional. The header identifier. 

The major header statements contain control information that applies throughout 
the compile of the entire system. A minor header, on the other hand, is a 
group of header statements immediately preceding a system element. The para- 
meters within a minor header are in effect only throughout the compilation of 
the particular system element that the header precedes. Minor headers are 
optional if sufficient information is included in the major header. Figure 
7-1 illustrates the positions of major and minor headers. 

Major and minor header may be retrieved from a CMS-2 library. In this case, 
the header statements are bracketed by HEAD and END-HEAD statements. The format 
of the HEAD statement follows: 

Format 

name HEAD comments $ 

Explanation 

HEAD Specifies a set of header statements to supple- 

ment major header controls or establish minor 
header groups . 

Name Optional. The header identifier. If the header 

group is to be included on a library, the name 
is required in order to identify the element on 
the library and for subsequent retrievals. 
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Below is a list of available header statements, divided into four categories. These 
statements will be defined and their usage described in following sections. 
1. Options header statements: 

OPTIONS 
2 . Allocation header statements: 
BASE 

TABLEPOOL 
DATAPOOL 
LOCDDPOOL 
EQUALS 
NIT EMS 

3. Library retrieval header statements: 

LIBS 

SEL-ELEM 

SEL-SYS 

SEL-HEAD 

SEL-POOL 

CORRECT 

DEP 

4. Miscellaneous header statements: 

SYS -INDEX 

MEANS 

EXCHANGE 

DEBUG 

CSWITCH-DEL 

EXECUTIVE 

CMODE 

SPILL 

CSWITCH-ON 

CSWITCH-OFF 

CSWITCH 

END-CSWITCH 

END-CSWITCHS 
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The OPTIONS, SYS-INDEX, and DEBUG statements are allowable only within a major 
header. DEP statements are restricted to minor headers. All the remaining state- 
ment types may be used in either category of header. The major headers must in- 
clude the OPTIONS statement. The statements of a major header may occur in any 
order except for the OPTIONS statement, which should precede all others. 

The comment features described in Section 3 are allowable within headers. 
7.3 OPTIONS HEADER STATEMENT 

Every compile-time system requires a major header containing at least the OPTIONS 
statement. This statement should immediately follow the SYSTEM statement. 

The OPTIONS statement designates the types of output, the output units and the various 
program listings to be generated by the compiler for a compile-time system. 

Format 



OPTIONS P r P 2 ,...p n $ 



Explanation 



OPTIONS 



Specifies the OPTIONS header. 

Denotes optional parameters of the following types: 

SOURCE Source output and disposition. 

OBJECT Object options, output, and disposition. 

LISTING Listing disposition. 

MONITOR Execution under Monitor. 

NONRT Execution in a non-real-time environment 



n 



allowing calls to implicit run-time functions. 
LEVEL(O) All error and warning messages are listed. 
This is the default condition. 



LEVEL(l) Warning messages are not generated. 
MODEVRBL Allows implicit definition of variables. 



STRUCTURED Specifies that the system is written 

according to CMS-2 structured programming 



conventions. 
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Any or all of these parameters may be specified in any order. If no parameters 
are given or no OPTIONS statement is included in the source input, the Compiler 
output consists only of syntax error messages. The first three controls listed 
above may be accompanied by subsidiary information in parentheses following the 
parameter. This additional information is described in the following paragraphs. 
The presence or absence of some of this information can affect the duration and 
comprehensiveness of the compilation. The number of outputs requested may be 
restricted by the installation's peripheral configuration. 

7.3.1 SOURCE Option 

This parameter calls for the listing, punching and/or tape output of the 
(edited) source statements input to the Compiler. The presence of this param- 
eter on the OPTIONS statement indicates a request for source output; the 
associated parameters indicate the disposition of this source. 



Format 



SOURCE (LIST, CCOMN, CSRCE, CARDS) 



Explanation 



SOURCE 



Requests output of edited source statements. 



LIST 



Optional. Indicates that disposition of source 
output is hardcopy listing. This is the default 
parameter and is only necessary if a hardcopy 



listing is desired in addition to one or more of 
the following parameters. 



CCOMN 



Optional. Indicates that the disposition of 
source is the output unit CCOMN. 



CSRCE 



Optional. Indicates that disposition of source is 
the output unit CSRCE which is unloaded at the 
end of the compile time system. 



CARDS 



Optional. Indicates source output in the form 
of punched cards. 
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Any or all of these parameters may be specified in any order. Whenever either 
CCOMN or CSRCE is requested, any hardcopy listing that results from either the 
LIST parameter or the OBJECT options will show the source statements numbered 
as in a Librarian listing. This Compiler output may then be used in lieu of a 
library listing of the source code. 
Kxampl i's 

] . Wfi'P/fS l I S l W l <H fc "i \ A I I I I I I I 1 I I I 1 I 1 II I I 1 I I 1 

I 1 ' I ' I MIIIIJIll II 1 I I I I i I I I I I I 1 1 J 1 1 1 



I 1 1 I I I I I I I I I I I I I I I I 1,1 I 

pfwwft i W i Vi^iVfiVi f l 



1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 



Requests ;i hardcopy listing of the source input, 

2. Q\?\T\l\OJI\S\ \^O^C^U^^ x L y / x S x T,\ M , , , , , , , , , | 

Requests a hardcopy listing and a punched deck of l he source input. 

3. Afir/.Q/fei ISAVACfjAWA), i i i , I , i i I 

Requests output of the source input to unit CCOMN (generally for a sub- 
sequent library update run). Any hardcopy listing of the source will have 
statements numbered according to Librarian conventions. 

7.3.2 OBJECT Option 

This parameter requests the Compiler to proceed all the way through its object 
generation phases. The subsidiary information with this parameter specifies 
special generation options, object-code listing forms, and disposition of 
relocatable binary object-card decks. 

NOTE 

If OBJECT is not specified on the OPTIONS 
statement, the Compiler will perform the syntax 
analysis phase only (producing syntax diagnostics) 
but will not proceed into the code generation phases. 
When SOURCE is present without OBJECT, the hard- 
copy source listing will have syntax error diagnostics 
interspersed with the source statements. 



II-7-7 



M-5035 
Change 5 



Format 

OBJECT 
Explanation 
OBJECT 



(Special -mode, list-options, CNV, CCOMN, COBJT, CARDS) $ 



List Options 



Requests object generation phases of the compilation. 
Special Mode Optional. One of the following: 

CMP Request a compool generation run. 

OPT Requests optimization of transient references. 

Optional. One or more of the following hardcopy output 
options: 

CR Requests both local and global cross-reference 

listings, which are alphabetized listings of the 
identifiers defined within the compile -time sys- 
tem, their assigned locations, and the locations 
that reference them. 
CRG Requests a global cross-reference only. 

CRL Requests a local cross-reference only. If CR, 

CRG, and CRL are omitted, only cross-reference 
listings of unallocated identifiers are given. 
SA Requests symbol analysis listings which provide 

a list of identifiers categorized according to 
declarative type. Within each grouping, the 
identifiers are alphabetized and accompanied by a 
summary description of their respective attributes. 
SM Requests a full symbolic output listing which pro- 

vides for the complete listing of the source 
statements intermixed with the octal and mnemonic 
representations of the generated machine code and 
their corresponding addresses. 
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CNV Optional. Specifies that f ixed-to-f loat and 

float-to-fixed numeric conversions are to be 
provided by run-time routines rather than in- 
line generation. 

CCOMN Optional. Indicates that disposition of relo- 

catable binary object-code is the output unit 
CCOMN. 

COBJT Optional. Indicates that disposition of relo- 

catable binary object-code is the output unit 
COBJT, which is unloaded at the end of the 
compile time system and may be saved. 

CARDS Optional. Indicates relocatable binary object 

code output in the form of binary punched-card 
decks. 

or all of the above primary parameters may be specified in any order. 

NOTE 

The special mode parameter CMP requests the 
creation of a compool output. This parameter 
may be used only with compile-time systems 
whose elements are system data designs and 
headers. The compool output is identified by 
the name of the last system data design and 
consists of the definitions of all the data 
design elements decoded into a format internal 
to the Compiler. A compool may be placed on a 
library tape and may be retrieved instead of 
the corresponding source system data designs 
for subsequent compile-time systems. Using 
such a compool saves the compilation time 
normally needed to process the source system 
data designs. 

The special mode parameter OPT requests 

optimization of transient references. The 
use of the parameter may result in the ele- 
ments of a system being no longer indepen- 
dently compilable. 
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Examples 

l - iQ^TT/iQAfS PA J7^C7T , 1 , i i iii i i i I i i i i i i ii i I 

Requests diagnostic output from all Compiler phases; no other output will 
be produced . 




Requests a hardcopy listing of source and diagnostics from all phases of 
the Compiler. Adjacent to each source statement is the relocatable 
location of the first instruction generated for that statement. These 
locations are useful if CR is also requested. 



Requests a local and global cross-reference, symbol analysis, and full symbolic hard- 
copy listing, along with diagnostics, from all phases of the Compiler. 

4. aPTJAMS, \S,o>U,K,C,e, r Pfi\r,e i cT l (,CAP lT C\DS^T l yS^\ *\ 

Requests a source listing and a full symbolic listing for a compool gen- 
eration compilation. The compool and its corresponding relocatable binary 
object code will be output on unit COBJT, which will then be unloaded. 

7.3.3 LISTING Option 

This parameter specifies the disposition of the hardcopy listings produced by 
the Compiler as a result of the parameters described in paragraph 7.3.2. It 
need only be specified if the hardcopy or printer output is to be written onto 
other output units instead of, or in addition to, being printed. 

Fo rma t 

LISTING (PRINT, CCOMN, CLIST) 
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Explanation 

LISTING Requests nonstandard hardcopy listing disposition. 

PRINT Optional. Indicates that disposition of printer 

listings is the printer. This is the default 
parameter and is only necessary if printer output 
is desired in addition to one or more of the 
following parameters. 

CCOMN Optional. Indicates that disposition of hard- 

copy listing output is the output unit CCOMN. 
CCOMN may not be used if specified in OBJECT option 

CLIST Optional. Indicates that disposition of hard- 

copy listing output is the output unit CLIST, 
which is unloaded and may be saved at the end of 
the compile time system. 

Any or all of the above parameters may be specified in any order. 

Examples 

am i at/A jaaracrt&n);,, A/frr,/^ ^ccpa^), A I 

Requests the full symbolic hardcopy output listing to be placed on unit 
CCOMN rather than to be printed. 



2. \OiP\T\/ \Q[MS[ ISrfWiftCfi idli/lSiT^, iCAKPA)\ai i » » i i i . i I 
I t l i t i i i \1\I\SJ\/k#&\ \(\f\R\l\M\Ti T \ \dLiliS\7\)\ rft . i i i i 



l. 



Requests a hardcopy listing and a punched card deck of the source input. 
The listing will be printed, as well as placed on the output unit CLIST. 

7.3.4 MONITOR Option 

The MONITOR parameter allows the compilation of statements that directly or 
indirectly require access to the CMS-2 operating system (i.e., high-level I/O 
and DEBUG statements). It also results in all testing of the special console 
conditions (e.g., KEYl, STOP5) to be simulated by the Monitor. This parameter 

II-7-11 



M-5035 
Change 3 



should be specified only when the object code produced by the Compiler is to be 
executed under Monitor control. See Volume I, Section 2 (Monitor) for simulated 
settings of special console conditions. 

7.3.5 NONRT Option 

The NONRT parameter indicates that the program is to be executed in a non-real-time 
environment and allows the generation of calls to implicit run-time functions 
(exponentiation, BIT/CHAR, and fixed/floating point conversion). The MONITOR option 
automatically implies the NONRT option. In the absence of NONRT (or MONITOR), all 
implicit references to these run-time functions will cause source warning messages 
and/or object error diagnostics. 

7. 3. 6 Two-Level Diagnostics 

Error listings produced by the Compiler contain two categories of diagnostic messages : 
serious errors which affect program execution and warning errors which may not affect 
program execution. The LEVEL(l) option causes suppression of the listing of errors 
in the warning category. A LEVEL(O) specification, or no specification of the LEVEL 
option, causes errors in both categories to be listed. Regardless of level specified 
or implied, errors in the warning category are not included in the COMPILE ERROR 
Summary at the end of the compile. 

7.3.7 MODEVRBL Option 

The MODEVRBL parameter instructs the compiler to create local variable definitions 
for any undefined data units appearing in dynamic statements where the syntax of the 
statement allows references to variables. These implicitly defined variables are given 
the attributes of the MODE VRBL declaration or the compiler's inherent mode (I 16 S) 
in the absence of a MODE VRBL declaration. 
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7.3.8 STRUCTURED Option 

The STRUCTURED option informs the compiler that the system is written 
according to the CMS-2 structured programming conventions. The Compiler 
will issue the warning message "NON-STRUCTURED STATEMENT" for the 
each statement which violates these conventions. These statements include: 

1. Statement switch declarations 

2. GOTO statements 

3. Procedure declarations containing abnormal exits 

4. Procedure call statements containing abnormal exits 

5. RETURN statements containing an abnormal exit 

6. SET statements containing an OVERFLOW specification 

7. Procedure Switch call statements containing an INVALID 
specification 
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7.4 ALLOCATION HEADER STATEMENTS 

The allocal ion scheme incorporated in the Compiler generally consists of the 
assignment of addresses to instructions and data definitions in a sequential 
manner that reflects the order of the source statements. All identifiers 
that function as symbolic addresses are assigned locations accordingly. In the 
case of a data name, the size of the area reserved is determined from its 
definition in a declarative statement. If the program subsequently specifies 
a preset value for the data unit, the Compiler generates the preset value 1 
originating at the location previously allocated. 

The requirements of a particular program or appl icat ion package often require 
departure from this standard allocation scheme used by the Compiler. For this 
purpose, various allocation header statements are provided in the CMS-2 language. 
Since the effect of these allocation statements on a user program often involves 
both the Compiler and the Loader, the reader should also refer to the descrip- 
tion of the CMS-2 Loader in Volume I, Section 3, in particular, the AC and 
CS directives. 

The words "allocation" or "relative allocation", when used to describe CMS-2 
for the AN/UYK-7, will refer to the positioning of an individual data unit or 
dynamic statement (TABLE, label, etc.) within a basic CMS-2 element (SYS-DD or 
SYS-PROC) . The words "relocatable allocation" will refer to the positioning 
(offset) of a CMS-2 element from its associated basic register content. 

7.4.1 Fooling Statements 

Two basic types of pooling statements exist. The first type directs the Com- 
piler to divide a basic element into two separate elements for the purposes of 
subsequent relocatable allocation by the Loader. Statements in this group are 
LOCUDPOOL and TABLEPOOL. If it is ever required to treat local data designs 
and/or tables as relocatable elements at load time, these statements must be 
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present, with their associated basic elements, SYS-PROC and SYS-DD respective- 
ly, during compilation of the source. 

The second type of pooling statement includes those pool statements that are 
associated with the basic CMS-2 elements. They are BASE and DATAPOOL . It is 
necessary to include these pool statements with the source only if machine and 
system-dependent information is included. 

In general, pooling statements may occur in both major or minor headers. Pool 
ing statements used in a minor header affect only the SYS-DD or SYS-PROC that 
immediately follows. (If a pool statement is used that is inappropriate, it i 
ignored by the Compiler; e.g., LOCDDPOOL within the minor header of a SYS-DD 
would be ignored.) 

If a pooling statement occurs in a major header, it applies to all basic ele- 
ments not having this pooling statement as a minor header. All four of the 
above pooling statements may appear in a header, but only one of each type may 
be specified (i.e., two BASE statements may not appear in the same header). 

Each of the pooling statements allows an optional name to be given for the pur 
pose of identifing the pooled element or group of elements. This name defines 
compound section and appears in the CS Loader directive generated by the Com- 
piler as part of the binary output. A compound section informs the Loader 
that relocatable elements are to be grouped together (see Volume I, Section 3) 
If no name is given on the pooling statements, the Compiler will provide 
default names. They are as follows: 

Pooling Statement Default Name 

BASE SYSP 

DATAPOOL SYSDD 

LOCDDPOOL LOCDD 

TABLEPOOL TABLE 
Furthermore, if neither the BASE nor the DATAPOOL statements are provided 

by the user, the Compiler will use the respective default names for the 
compound section specifications. 
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One of the parameters appearing in all of the following pooling statements 
specifies that the data or instructions in the pool be referenced using a 
transient base register. This parameter should be used only for extremely 
large programs . 

7.4.1.1 LOCDDPOOL Statement 

The LOCDDPOOL statement instructs the Compiler to compile the local data de- 
signs with reference to a separate base (i.e., as a relocatable element) . If 
found in a major header, it instructs the Compiler to compile all local data 
designs in this manner. (A LOCDDPOOL also found in a minor header would be 
redundant unless it had a different name, requested transient reference, or 
suggested grouping under a different base register.) 

If found in a minor header, only the local data designs of the associated SYS- 
PROC will be compiled as a relocatable element. All other local data designs 
will be based relative to the base of the SYS-PROC as encountered within the 



source. 



Format 



name LOCDDPOOL (T, identifier) optional-value $ 



Explanation 



name 



An optional name assigned to this element or 
group of elements. This name defines a compound 
section and appears in the CS Loader directive 
generated by the Compiler as part of the binary 
output. 



LOCDDPOOL 



Identifies a local data-design pool. 



T, Identifier 



An optional implementation aid. If not present, 
normal conventions will be used. If T is present, 
it specifies that the local data designs covered 
by this pool statement should be referenced 
transiently. The identifier, if present, spe- 
cifies the AN/UYK-7 base register under which 
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Optional Value 



this element m;iy he ;il 1 orated . This infor- 
mation is passed on to the Loader but may 
be overridden at load time. The identifier 
may be an EQUALS tag or a positive integer 
constant. 

The absolute allocation at which it is 
desired that this element (or group of 
elements) be located at load-time. The 
Compiler passes this information to the 
Loader. The Loader allows this value to 
be overridden at load time. 



Example 



i i i i i i i 


i i Pi/Pi'Fri m rn c i 
i i 1 i i*i i i i i i i 1 i i 


i^i ai irrri'i^i i'w 

1 1 M i 1 1 1 1 1 1 1 


Jl 1 1 1 1 

Mini 


i i i i i i i 


i i 1 i i # i i i i i i i i | 


1 1 1 1 1 1 1 1 1 1 1 1 


Mini 


iWi i 




y txOMiOi ,A 


i i i i i 


i i i i i i i 


i i l*VHfl-i/*i*A>i 4 , , 


i 1 1 II 1 1 II II 


Mini 


i ii i u i 


II 1 Tl 1 II 1 1 I it 


II 1 l I 1 I 1 II 11 


Mini 


1 MINI 


ill 1 1*1 i 1 1 1 1 I 1 1 I 


1 1 1 1 1 1 1 MM 


Mill! 




i i .&yiSi-iPi*,aci .*i i . 


. 1 I 1 1 1 1 1 1 1 1 1 


Mill! 


i i i i i i i 


i i i Ti i i i i i i 1 i i 


II 1 1 1 1 1 ill! 


i i i ii 1 


Mill II 


ii i i * i i i i i i i lit 


1 1 i 1 1 1 1 1 1 1 M 


Mini 


1 III Ml 


i i Mi-|Si y iSi-|Pi«|o,c, 


.TiMiC W\ i i i 


Mill 



This example represents a program which, because of system design, 
found itself with a shortage of base registers. Since the programmer 
realized that he made few references to his own local data designs, he 
commands the Compiler to use a transient base register whenever any local 
data is requested in his program. He further commands the Compiler to 
indicate to the Loader to use S6 as the transient register and to base 
his local data at address 40000. This can be changed at load time. 
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7.4.1.2 TABLEPOOL Statement 

The TABLEPOOL statement instructs the Compiler to compile all applicable tables 
with reference to a separate base location. The TABLEPOOL applies only to 
tables declared in a SYS-DD. 

If this pool statement is present in the major header, it is applicable to all 
tables declared in all SYS-DD's not having a TABLEPOOL statement in their minor 
header. If this statement is present in the minor header of a SYS-DD, it 
applies only to tables declared in that SYS-DD. 

Format 

name TABLEPOOL (T, identifier) optional-value $ 
Explanation 

Name An optional name assigned to this element or 

group of elements. This name defines a compound 
section and appears in the CS Loader directive 
generated by the Compiler as part of the binary 
output. 

TABLEPOOL Specifies pooling of all tables with reference to 

a separate base location. 

T, Identifier An optional implementation aid. If not present, 

normal conventions will be used. If T is present, 
it specifies that the tables declared in the 
SYS-DD covered by this pool statement should be 
referenced transiently. The identifier, if 
present, specifies the AN/UYK-7 base register 
under which this element may be allocated. This 
information is passed on to the Loader but may be 
overridden at load time. The identifier may be 
an EQUALS tag or a positive integer constant. 
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Optional Value 



The absolute allocation at which it is desired 
that this element (or group of elements) be 
located at load time. The Compiler passes this 
information to the Loader. The Loader allows this 
value to be overridden at load time. 



7.4.1.3 BASE Statement 

The BASE statement instructs the Compiler to compile system procedures with 
reference to a separate base location. This pool statement is considered to be 
present in the major header by default. 

If this pool statement is present in the major header, it is applicable to all 
SYS-PROC*s not covered with a BASE statement in a minor header. 



Format 

name BASE 
Explanation 
Name 



BASE 



T, Identifier 



(T, identifier) optional-value $ 

An optional name assigned to this element or 
group of elements. This name defines a compound 
section and appears in the CS Loader directive 
generated by the Compiler as part of the binary 
output. 

Specifies pooling of all instructions with refer- 
ence to a separate base location. 

An optional implementation aid. If not present, 
normal conventions will be used. If T is present, 
it specifies that the generated instructions 
covered by this pool statement should be refer- 
enced transiently. The identifier, if present, 
specifies the AN/UYK-7 base register under which 
this element may be allocated. This information 
is passed on to the Loader but may be overridden 
at load time. The identifier may be an EQUALS 
tag or a positive integer constant. 
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Optional Value The absolute allocation at which it is desired 

that this element (or group of elements) be 
located at load time. The Compiler passes this 
information to the Loader. The Loader allows this 
value to be overridden at load time. 

7.4.1.4 DATAPOOL Statement 

The DATAPOOL statement instructs the Compiler to compile system data designs 
with reference to a separate base location. This pool statement is considered 
to be present in the major header by default. 

If this pool statement is present in the major header, it is applicable to all 
SYS-DD's not covered with a DATAPOOL in a minor header. 

Format 

name DATAPOOL (T, identifier) optional-value $ 
Explanation 

Name An optional name assigned to this element or 

group of elements. This name defines a compound 
section and appears in the CS Loader directive 
generated by the Compiler as part of the binary 
output. 

DATAPOOL Specifies pooling of all data with reference to 

a separate base location. 

T f Identifier An optional implementation aid. If not present, 

normal conventions will be used. If T is present, 
it specifies that the data designs covered by this 
pool statement should be referenced transiently. 
The identifier, if present, specifies the AN/UYK-7 
base register under which this element may be 
allocated. This information is passed on to the 
Loader but may be overridden at load time. The 
identifier may be an EQUALS tag or a positive 
integer constant. 
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Optional Value 



The absolute allocation at which it is desired 



that this element (or group of (dements) be 
located at load time. The Compiler passes this 



information to the Loader. The Loader allows 



this value to be overridden at load time. 



7.4.2 EQUALS Statement 

The EQUALS statement is used for two purposes: the assignment of numeric 
values to symbols and the specification of relative allocation. 

If the EQUALS statement is contained in a major header or system data design, 
the EQUALS statement applies throughout the system and the value will be 
substituted wherever the name appears. If the EQUALS statement appears in a 
minor header or local data design, the value will be substituted only through- 
out the system procedure or data design which follows the minor header. 

When the EQUALS statement is used to assign a numeric value to a symbol used 
in the following procedures or data designs, the values used in the arithmetic 
expression must be either constants or values previously defined by an EQUALS 
statement, or previously specified in a system data design within the system 
being compiled. Arithmetic expressions appearing in EQUALS statements must be 
simple, parenthesis-free expressions and are evaluated left to right without 
precedence consideration. Relative allocation is accomplished with the EQUALS 
statement where the right-hand side references data units. 

Format 

name EQUALS expression $ 
Explanation 

Name The name of a data unit, or a tag for a numeric 



constant . 



EQUALS 



Specifies that an allocation or value assignment 
follows . 



Expression 



A simple, parenthesis-free expression repre- 
senting a relative allocation or numeric value. 
The basic arithmetic operations of +, and / 
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are allowed. The operands in this expression 
may be data unit names, tags defined by previous 
EQUALS, and constants. Table 10-1 summarizes the 
rules for legal final results (left side of 
EQUALS) and legal intermediate results (binary 
operations within the expression on the right 
side of the EQUALS) . 



TABLE 7 -1 . EQUALS EXPRESSION SUMMARY 



ONE 
OPERAND 


OPERATOR 


OTHER 
OPERAND 


RESULT 
(FINAL OR INTERMEDIATE) 


Constant (tag) 


+ _ * / 


Constant (tag) 


Constant (tag) 


Relative (data 
unit) 


+ - 


Constant (tag) 


Relative (data unit) 


Constant (tag) 


+ 


Relative (data 
unit) 


Relative (data unit) 


Relative (data 
unit) 




Relative (data 
unit) 


Constant (tag) 



7.4.2.1 Defining a Tag 

When neither the name on the left nor any of the names on the right of an 
EQUALS statement are the identifiers of data units, the name on the left 
becomes a tag for the numeric value represented by the expression on the right. 
This tag may then be used in data declarations and dynamic statements and the 
appropriate value will be substituted. If the expression on the right involves 
data units (relative locations) and the result is an integer value, the tag 
may be used in dynamic statements or other EQUALS statements but not in data 
declarations. 
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Example 





?l ! 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


i i A 

m i i «m*,L,S, ,F,IV/ 


Zk \i\ 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


iMAifin l IfiduVHiLiS .Fitf- 


1*1 mill 1 I 1 1 1 1 1 1 I 


1 1 1 1 1 1 1 l'i 1 1 1 1 1 1 


1 II I II II 1 1 1 1 1 1 i 1 1 1 I 


i i i I i 1 i i*i i i i i 


1 1 1 1 1 1 1 1 1 1 l.l 1 1 J L-L-L- 


iViKi8,l, IXi A iFiM Si iR 


Vtx |P MA/n 1^1 1 1 1 1 1 1 1 1 i 


i i i i i 1 i i # i i i i i i i 


i i i i i I 1 1 1 i i i l l I i 1 


I I I L. 1 1,1*1, 1 1 1 .1..J-...I— 


1 1 1 1 1 1 1 1 1 1 1 i i, 1 .J .i.. 


i5,FiTi i Ki iTiO, & ft fi 


hfc 4\ i i 1 1 1 i 1 1 1 1 1 1 1 i.,. 



The variable X is a 32-bit, signed, fixed-point data unit with 16 
fractional bits and an initial value of 15. Execution of the SET state- 
ment assigns the value 30 to the variable X. 

7.4.2.2 Establishing Relative Locations 

The EQUALS statement may Ue used to assign the location of a name relative or 
equal to the location of another name. The definitions of these names must 
appear within the same system element. The identifier used on the left side 
of an EQUALS statement must be a data name for a table, like-table, item-area, 
variable or switch. The expression on the right involves data unit names, 
tags, and constants. 

If a data name appears on the left side of the EQUALS statement, no area for 
the data definition is reserved by the Compiler. During the allocation pro- 
cess, the allocation counters are not altered; the affected data definition is 
removed from the normal assignment sequence and is allocated relative to the 
data name appearing to i ho right of the EQUALS. (If the data name on the right 
does not appear on the left of an EQUALS statement, its data definition re- 
ceives normal allocation and reservation of area by the Compiler.) A statement 
label may not appear on the left of the EQUALS statement. 



1 1-7-21 



M-5035 
Change 3 



Example 

\f\\ i i i I^Mi'UiSi \ 3\ \ $\ i I I i i i i i i i i i i i i i i 

\C\ I i I i \fk l+i iii Si i i i i I i i i i i i i i i 



Storage is allocated for B, but is not reserved for A or C. A occupies 
the same location as B, and C occupies the next consecutive memory location 



7.4.3 NITEMS Statement 

The NITEMS statement is a special case of the EQUALS statement as used to tag 
an identifier to a constant. Its purpose is to assign a value to a tag appear- 
ing as the number-of-i terns specification in a vertical table. 

Format 

NITEMS (identifier) EQUALS value $ 
Explanation 

Indicates a special case of the EQUALS statement. 



NITEMS 
Identifier 



A tag used on a subsequent table declarative to 
represent the number of items. 



EQUALS Specifies an EQUALS declaration. 

Value An integer constant or another identifier tagged 

to a constant by a previous EQUALS statement. 
The NITEMS statement provides an initial constant for the number of items of a vertical 
table declaration using the tag and also provides a name to which another value may be 
attached at load time; thus, the length of a table may be changed without recompiling the 
program. As a result no fields of a table whose length is determined by a NITEMS tag may 
be preset. 

7.5 LIBRARY RETRIEVAL HEADER STATEMENTS 

Elements of a compile-time system may be retrieved from CMS-2 libraries and 
Compiler output tapes as part of the input to the Compiler. These include 
header and system elements containing source statements and compool elements, 
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which are compiled system data designs, in a format internal to the Compiler. 

The following paragraphs describe the control statements needed to retrieve 
source elements and compools. Additional control statements are provided for 
the purpose of correcting source elements during element retrieval. These 
library retrieval and correction statements may be used either in major or 
minor headers or in place of system elements of a cumpile-<time system. Library 
features are described in Volume I, Section 4. 

7.5.1 LIBS Statement 

Prior to control statements that select elements from a library, the library 
must be identified by a LIBS statement. 

Format 

LIBS internal-id (external-id) $ 
Explanation 

LIBS The statement identifier. 

Internal ID The name of the library or Compiler output. 

External ID Optional. Some external identification (such as tape reel 

number) which will be output to the compiling system 
operator. If not given, the internal ID will be used. 
When Compiler -produced outputs are used in library retrieval, the names CCOMN, 
CSRCE or COBJT must be used as the internal -id. The name used corresponds to 
the one specified on the OPTIONS statement when the tape was produced by the Com- 
piler. Sources statements may be retrieved from CCOMN or CSRCE; compools from 
CCOMN or COBJT. If CCOMN is being used as library input and CCOMN has been 
specified on an OPTIONS statement as an output file, the LIBS statement must include 
an external -id other than CCOMN to distinguish between the two files. 

7.5.2 Retrieval Selection Statements 

Elements on a library are identified by name and an optional key. The key is required 
if the elements selected have been given a key during library preparation. Element 
keying provides a means of distinguishing between elements of the same name on a 
library. 

I I -7 -23 



M-5035 
Change 4 



The name of a source element for retrieval is the name specified on the HEAD, SYS-DD 
or SYS-PROC statement. The name of a compool element is the name of the last 
SYS-DD used to create the compool. The name and the HEAD, END-HEAD, SYS-DD, 
KND-SYS-DI), SYS-PROC and EN D-SYS-PROC statements define and delimit an 
element during the retrieval process. 

Retrieval of elements from a library is achieved through selection statements which 
specify the desired elements by name and/or key. There are four types of SEL control 
statements: SEL-ELEM, SEL-SYS, SEL-HEAD and SEL-POOL. 



Formats 



SEL-ELEM name (key) , dep-option $ 
SEL-SYS (key) $ 

SEL-HEAD name (key), dep-option $ 
SEL-POOL name (key) $ 



Explanation 



SEL-ELEM, SEL-SYS, 
SEL-HEAD, SEL-POOL 



Statement identifiers. 



Name 



Identifies the element desired for retrieval. 



Key 



Required only if the named element has a key 
on the library. If not required, the parentheses 



and key are omitted; the key is considered blank. 



Dep-option 



Optional. Specifies the level of dependent 



element retrieval. A dep-option may be one of 



the following: 



ALL 



retrieve all dependent 
elements 



ONLY 



retrieve no dependent 
elements 
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no-of -levels retrieve the specified levels 
of dependent elements 

No-of-levels is an integer or an EQUALS defined 
name of an integer. These integers have the 
following interpretations: 

all dependent elements, equivalent 
to ALL 

1 no dependent elements, equivalent 
to ONLY 

2 this element and one level of 
dependencies 

3 this element and two levels of 
dependencies, etc. 

If no dep-option is given, ALL is assumed. This 
parameter is used only in conjunction with libraries 
and is ignored when retrieving from Compiler 
output tapes. 

The SEL-ELEM statement causes the retrieval of a specific system element and 
possibly all its declared dependent elements; it may not appear in a major header. 
The SEL-SYS statement requests the retrieval of all elements having the specified 
key. All source elements are retrieved when the key is blank. The SEL-HEAD 
statement causes the retrieval of the named major or minor header and possibly 
all corresponding dependent elements. The SEL-POOL statement causes the 
retrieval of the named compool. 

NOTE 

SEL-SYS statements may be used in conjunction with 
SEL-ELEM and SEL-HEAD statements. The order 
of retrieval is dependant upon the order of the 
elements on the library. A single correct deck (with 
elements referenced in their library order) may be 
used to update elements called by a combination of 
SEL statements. 
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The SEL-POOL statement must appear in an unnamed major header of the compile- 
time system such that it precedes all user-defined identifiers except the system name. 
Retrieval of a compool occurs immediately when requested. Retrieval of elements 
specified in one or more consecutive select statements commences when one of the 
following conditions occur: 

a. The Compiler detects the CORRECT statement. 

b. The Compiler encounters a CMS-2 statement other than the LIBS or 
select statements. 

c. The number of consecutive select statements exceeds 60. 

When retrieval is completed for a given set of requests and corrections, the 
Compiler returns to the standard system input device for the rest of the user's 
input to the Compiler. 

7.5.3 Correcting Elements During Library Retrieval 

Source elements may be corrected during the retrieval process; compools may 
not. The corrections do not modify the library or Compiler output tape itself, 
but only the elements as they are passed to the Compiler. The name of the 
element and the card image sequence numbers, as given in the library listing, 
provide the reference points for making corrections in the form of deletion, 
insertion or replacement of card images. The Compiler listings produced during 
a SOURCE output onto CCOMN or CSRCE also provide the same card image sequence 
numbers. 

Corrections decks must be introduced by the statement: 

CORRECT $ 

which indicates that one or more of the elements (that are to be retrieved as 
directed by preceding SEL control statements) are to be corrected. Since 
CORRECT is a CMS-2 statement, it may not start in card columns 1 through 10. 
The CORRECT card is followed by correction controls (as described in Volume I, 
Section 4) and CMS-2 statements. The correction deck is terminated by the 
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Librarian directive /ENDCOR. Within a block of corrections, thj order of the 
corrected elements must be that of the library or Compiler output tape. 

7.5.4 PEP Statement 

For any given element of a compile-time system, the programmer may declare other 
elements to be dependent or subordinate to the given element. Such a specification 
of dependents may appear only in a minor header. An element may have a 
maximum of 58 dependent elements. Any minor header source element is automatically 
declared a dependent element of the associated system element. 

The DEP statement has no direct effect on the compile process; the information is 
simply passed through to the source or relocatable output. The dependent element 
concept has bearing primarily upon the Librarian process and the relocatable loader. 
In library retrieval, whether of source or relocatable elements, dependent elements 
are retrieved automatically with the selected element unless otherwise specified by 
the user. Furthermore, during relocatable loading, all declared dependent elements 
must be satisfied. 

Format 

DEP name (key), name (key), ... $ 
Explanation 

DEP Declares a dependent element. 

Name The name of another element such as a system 

data design or system procedure. 

Key An optional key value placed on the element. 

7*5.5 Key Specification 

Various programmer selected outputs from the Compiler may be incorporated into 
libraries. Elements on such libraries are identified by name and an optional key. The 
of an element output by the Compiler is automatically defined as the name given 
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on the associated HEAD, SYS-DD or SYS-PROC statement. Key specification provides 
the programmer with the option of defining library element keys at compile time. 

Key specification may be included in the SYSTEM, HEAD, SYS-DD, SYS-PROC and 
SYS-PROC-REN statements (see Section 4). This section describes the key specification. 

Formats 

(key) 

(key)*S 

(key)*0 

(key)*C 

(key)*L 

Explanation 



Key Alphanumeric identifier of not more than four 

characters. 

S Specifies that the key is to be attached to a 

source element. 

O The key is to be attached to an object element. 

C The key is to be attached to a compool element. 

L The key is to be attached to a listing element. 



More than one key may be specified on any of the applicable declarative statements; each 
"(key)*element-type" is separated by a comma. Key specification included in the SYSTEM 
statement applies to all elements of the designated type output for the compile-time system 
Key specification included in the HEAD, SYS-DD, SYS-PROC and SYS-PROC-REN state- 
ments apply only to outputs associated with that element. If system declared key specifica- 
tions and an element declared key specification designate the same type of output, the 
element key is used. Finally, if no output type is attached to the key specification, all output 
types are keyed; if no key specification is given, all output elements are keyed with blanks. 
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7. 6 MISCELLANEOUS HEADER STATEMENTS 

7.6.1 SYS-INDEX Statement 

The SYS-INDEX statement may be used only in a major header. This statement as signs 
a unique identifier to a particular index register. This register is reserved throughout 
the entire system for use wherever the identifier is referenced. 

Format 

SYS-INDEX n identifier $ 

Explanation 

SYS-INDEX Specifies that a system index is to be declared. 

N An integer specifying a machine index register 

number from 1 to 5. 

Identifier A unique identifier to which the index register 

is to be assigned. 

Example 

iSiViSH/i^J^Xj ) A i |X,P|OiS| i i$i i , 1 i i i i i i i i . I 

The index (B-register) 1 is assigned the name XPOS throughout the system compile. 

7.6.2 MEANS Statement 

The MEANS statement provides a method of character substitution during the compila- 
tion process; no permanent changes are made to the affected source statements. 

Format 

identifier MEANS character-string $ 
Explanation 

Identifier Indicates where the substitution is to be made during 

the compilation. The identifier appears in subsequent 
statements (but never in another MEANS or EXCHANGE 
statement). 

MEANS Specifies that a character substitution is to be 

defined. 
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Character Strong A string of characters that is to be used in 

place of the identifier. It consists of all 
characters between the term MEANS and the dollar 
sign excluding the blank delimiter. It may 
include other identifiers, constants or CMS-2 
symbolic operators. Since the dollar sign 
terminates the string, it may never appear within 
the string as a character to be substituted. 
The maximum number of characters is 132. 

If the MEANS is contained in a major header, it applies throughout the system 
and the character string will be substituted wherever the name appears. If 
the MEANS appears in a minor header, the string will be substituted only 
throughout the system procedure or data design that follows the minor header. 

Examples character-string 

/ JN * 

lAiTiT./;, |M,g;MS, , A, 3U*-& liiA i A I i m i i i i i i I ■■ . 
iCftfif.q ft EMS, , ■ ft 

V ; -v- / ' 

character-string 

The following statements illustrate the before and after effects of the 
above character substitutions for the purposes of Compiler interpretation: 

iVlftlftlll irtlAfllfifl l/jiTlflft ifl 1 I 1 1 1 I I I I I I 1 I I I I I Before: 
iVlRglti lA/lAlMlEj/l I lAl l3Lh l5l \J\0 I l lil I I ll I H H After: 

iSiEiTi iR/iXiPlri i7fo iYi»ifia i Hi iCiPieiFifi "rfi I n i i n Before: 

! iSlfifTl lPl/ l»lflfl iflfl lYl*l»Ql h l(lXl/fll)l*l»l3l I 11 4\ \ After: 
7.6.3 EXCHANGE Statement 

The EXCHANGE statement provides exactly the same capability as the MEANS state- 
ment, except that the specified character substitution appears in the source 
output and Compiler listings. 

Format 

identifier EXCHANGE character-string $ 
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Identifier Indicates where the substitution is to be made 

during the compilation. The identifier appears 
in subsequent statements (but never in another 
MEANS or EXCHANGE statement). 

EXCHANGE Specifies that a character substitution is to be 

defined. 

Character String A string of characters that is to be used in 

place of the identifier. It consists of all 
characters between the term EXCHANGE and the 
dollar sign excluding the blank delimiter. It 
may include other identifiers, constants, or 
CMS-2 symbolic operators. Since the dollar sign 
terminates the string, it may never appear 
within the string as a character to be 
substituted. The maximum number of characters 
is 132. 

7.6.4 DEBUG Statement 

Various program checkout statements, as described in Section 8, may be included 
in the system elements of a compile-time system. These statements are proc- 
essed by the Compiler. Appropriate calls and parameters for the object -time 
debug package are generated and included in the object-code output only if the 
user so requests via the use of the DEBUG control statement in the major header 
element. 

Format 

DEBUG parameters $ 

Explanation 

DEBUG Requests the Compiler to process those types of 

program debug statements specified by the para- 
meters . 

Parameters Consist of one or more of the following names 

separated by commas: DISPLAY, SNAP, RANGE, 
TRACE, PTRACE, DELETE. 
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The DISPLAY, SNAP, RANGE, and TRACE parameters permit the compilation of the 
corresponding types of source debug statements. If one of these parameters is not 
included in the DEBUG header, the corresponding statements in the system elements 
are ignored by the Compiler. The PTRACE parameter specifies that code is to be 
generated during the compilation process to cause a print message to appear during 
execution before every procedure call. The DELETE parameter specifies that all 
debug statements not activated by the other parameters are to be deleted from the 
source output and listings. 

7.6.5 CSWITCH Declarations 

The CSWITCH feature provides selective compilation of specified sequences of state- 
ments within a compile -time system. The CSWITCH selection declaration defines the 
"on/off" setting. The CSWITCH bracket defines the sequences of statements. The 
CSWITCH delete declaration instructs the Compiler to remove those sequences which 
are "off. " 

7.6. 5.1 CSWITCH Selection Declaration 

CSWITCH -ON defines the named CSWITCH sequences to be compiled. 

CSWITCH -OFF defines the named CSWITCH sequences to be ignored. This declara- 
tion is optional; a CSWITCH bracket sequence whose name has not been defined by a 
CSWITCH selection declaration is considered to be "off. " 

Format 

CSWITCH -ON name-1, name-2, name-n $ 
CSWITCH -OFF name-1, name-2, name-n $ 

Explanation 

CSWITCH -ON Specifies that the listed groups of statements 

are to be compiled. 

CSWITCH -OFF Specifies that the listed groups of statements 

are not to be compiled. 
name-1, . . . , name-n Names that identify the selected CSWITCH 

groups of CMS-2 statements. 
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A CSWITCH selection declaration may appear anywhere within a compile-time system 
except within direct code and between a FIND statement and its corresponding IF data 
Statement. The CSWITCH name follows the standard CMS-2 local/global conventions. 
The "on/off" setting of a CSWITCH name may be reversed at any time during the com- 
pile by including the opposite CSWITCH selection declaration. If the setting of a global 
CSWITCH name is reversed within a system procedure (locally) it is reset to the global 
setting after the END-SYS-PROC has been processed. If a CSWITCH selection declara- 
tion appears within a CSWITCH bracket sequence and reverses the setting of the CSWITCH 
bracket name, the reversed setting does not affect processing of that CSWITCH bracket 
sequence. 

7.6.5.2 CSWITCH Brackets 

The sequence of statements between the CSWITCH bracket declaration and the END- 
CSWITCH bracket declaration is to be compiled, depending on the "on/off" setting of 
the CSWITCH name. The CSWITCH bracket may appear anywhere within a compile- 
time system except within direct code and between a find statement and its correspond- 
ing IF data statement. 

Format 

CSWITCH name $ 
END -CSWITCH name $ 
END-CSWITCHS $ 

Explanation 

CSWITCH Brackets beginning of CSWITCH block. 

END -CSWITCH Brackets end of a CSWITCH block. 

END-CSWITCHS Terminates all CSWITCH sequences, 

name A name of a CSWITCH block. Must correspond to 

a name in a CSWITCH selection declaration. 

CSWITCH brackets may be nested up to a maximum of 10 ("on" or "off") with a last -on 
first -off sequence. The name following END -CSWITCH terminates that CSWITCH name 
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sequence. If the CSWITCH sequence is M o££," only CSWITCH warnings are diagnosed; 
all other syntax checking is suspended until the END-CSWITCH bracket declaration 
is encountered or the language boundary structure has been violated. A CSWITCH 
bracket declaration in a data design (local, global or auto) , procedure , function 
or system procedure must have the END-CSWITCH bracket declaration prior to the 
respective data design bracket (local, global or auto), END-PROC, END -FUNCTION 
or END-SYS-PROC declaration. 



A CSWITCH bracket declaration appearing in a header 
(major or minor) will not be terminated until its cor- 
responding END -CSWITCH bracket declaration, an END - 
SYSTEM, a TERMINATE, or a monitor control card is 
encountered. If the END -CSWITCH bracket declaration 
is not encountered, the remainder of the source will not 
be compiled when the CSWITCH bracket declaration is 
"off. " 



7.6.5.3 CSWITCH Deletion 

The CSWITCH delete declaration may appear only in a major or minor header. If 
in a major header, all sequences of "off" CSWITCH brackets following within the com- 
pile -time system are deleted from the listing and source outputs. If in a minor header, 
all sequences of "off" CSWITCH brackets through the end of the following element are 
deleted from the listing and the source outputs. 

Format 

CSWITCH -DEL $ 

7.6.5.4 CSWITCH Example 
EXMP1 SYSTEM $ 



NOTE 



CSWITCH -ON CSWA1, CSWA2 $ 
CSWITCH -OFF CSWA3, CSWA4 $ 
END -HEAD $ 
SDD1 SYS-DD $ 



Major header. 
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CSWITCH CSWA2 $ 

CSWITCH-ON CSWB2 $ 



END -CSWITCH CSWA2 $ 

CSWITCH CSWB2 $ 

CSWITCH CSWA3 $ 

END-CSWITCHS $ 

END-SYS-DD SDD1 $ 
SPC1 SYS-PROC $ 
LOC-DD $ 
CSWITCH CSWA1 $ 

END -CSWITCH CSWA1 $ 

CSWITCH CSWA3 $ 

END -LOC-DD $ 



CSWITCH CSWA2 is set "on" in the 
major header; this sequence wlil 
compile and CSWB2 will be set M on. " 



Statements from CSWB2 to CSWA3 
will compile. Statements from CSWA3 
to END-CSWITCHS will be ignored. 



Will compile. 



Will not compile. END -LOC-DD 
will produce END -CSWITCH MISSING 
diagnostic. 
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CSWITCH-OFF CSWA2 $ 
PROCEDURE PROC1 $ 



CSWITCH CSWA2 $ 



END-CSWITCH CSWA2 $ 



END-PROC PROC1 $ 



END-SYS-PROC SPC1 $ 
HED1 HEAD $ 



Will set "off" CSWA2. 



Will not compile. 



CSWITCH CSWA3 $ 
END -HEAD HED1 $ 
SPC2 SYS-PROC $ 



END-SYS-PROC SPC2 $ 
HED1 HEAD $ 
END-CSWITCH CSWA3 $ 



Will not compile. 
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CSWITCH CSWA2 $ 
END -HEAD HED1 $ 
SPC2 SYS-PROC $ 

CSWITCH CSWA1 $ 

CSWITCH CSWA3 $ 

CSWITCH CSWB2 $ 

END-CSWITCH CSWB2 $ 

END-CSWITCH CSWA3 $ 

END-CSWITCH CSWAl $ 

END -SYS-PROC SPC2 $ 
HED2 HEAD $ 
END -QSWITCH CSWA2 $ 
END -HEAD HED2 $ 
SPC3 SYS-PROC $ 
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CSWITCH CSWA1 $ 



CSWITCH CSWA2 $ 



CSWITCH CSWB2 $ 



END-CSWITCHS $ 



END-SYS-PROC SPC3 $ 
END -SYSTEM EXMP1 $ 



All will compile. END- 
CSWITCHS terminates 
the sequence. 
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7.6.6 EXECUTIVE Statement 

The EXECUTIVE statement may appear in a major or minor header and is used to in- 
form the Compiler that the program generation is for use in the interrupt (executive) 
state of the AN/UYK-7. (The Compiler requires this information when generating 
control memory references to index registers and accumulators). The Compiler 
assumes generation for the task state in the absence of this statement. 

Format 

EXECUTIVE $ 

Explanation 

EXECUTIVE Indicates code generation to be executed 

in the executive statement 
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7.6.7 CMODE Statement 

The CMODE statement may appear in a major or minor header and is used to in- 
form the Compiler that octal is to be the implied mode for numeric constants 
in the element or elements which follow. This statement provides for com- 
patibility with other versions of CMS-2 in the method of expressing constants. 

Format 

CMODE $ 

Explanation 

CMODE Specifies that the implied mode of numeric 

constants is to be octal. 

When this statement is included in a header, decimal constants must be 
followed by a D or must appear in parentheses and be prefaced by a D. Un- 
modified constants or constants enclosed in parentheses and prefaced by an 
will be treated as octal constants. 



Examples 




7.6.8 SPILL Statement 

The SPILL statement may appear in a major or minor header element. 
Format 

SPILL $ 
Explanation 

SPILL Causes the Compiler to declare, at output time, 

every identifier within each affected system pro- 
cedure as an external definition. 
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This declaration primarily facilitates the patching of resultant relocatable 
object code by permitting the use of symbolic addresses (such as statement 
labels, procedure names or data names) to specify the locations to be patched. 
This declaration does not alter the normal scope of identifiers during the 
compilation process. 

If SPILL appears in a major header, all local identifiers will be declared as external 
definitions at output. If in a minor header, only those identifiers in the following 
element will be declared as external definitions at output. 
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SECTION 8 
DEBUG STATEMENTS 

A set of program checkout statements provides the capability for flow analysis 
and data display while an object program is being executed under control of the 
operating system. One or more types of program checkout statements may be 
included in the source input. When the corresponding statement types are 
enabled, these statements generate calls to debug package routines (see 
paragraph 7.6.4). Debug package routines may then be selectively activated 
at program load time (see Volume I, Section 3 for usage of the CMS-2 Loader). 

Therefore, the following three conditions must be fulfilled when one or more 
debug capabilities are desired: 

1. The DEBUG header card must be present 
with the desired debug aid as a parameter. 
This card instructs the Compiler to generate 
the code for that aid when encountered. 

If the debug aid is not included in the 

header statement, the Compiler will ignore 

the debug aid and will not generate code for it. 

2. The debug aid, as discussed in this section, 
must be located in the source program deck. 

3. The desired debug aid must be included as 

a parameter on the $LOAD card (see Volume I, 
Section 3). This parameter instructs the 
Loader to set Monitor flags directing execution 
of the instructions associated with that debug 
aid. Absence of the debug aid parameter will 
cause the instructions associated with that 
missing parameter to be bypassed during program 
execution. 
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The various types of program checkout statements and the results of enabling 
these statements at compile and load time are described in the following 
paragraphs. 

8.1 DISPLAY STATEMENT 

The DISPLAY statement allows the contents (image) of specified data units to 
be output on the system output device in the appropriate format for that data 
type. Optional value conversion will be made if stated. 

Format 

name DISPLAY image V(w,y), image V(x,y),... , image V(x,y) $ 
Explanatio n 

Name Optional. An identifier for this state- 

ment. If included, this identifier must 
be followed by a period and is printed 
with the data units and their contents. 
This name is not a statement label and 
therefore may not be referenced. 

Image REGS for machine registers or the identi- 

fier of a variable, table, subtable, like- 
table, item-area, or field. This data- 
unit reference identifies the image on 
the printout. 

The output format for REGS, table, sub- 
table, like-table, and item-area words 
is an 11-digit octal number. 

The data type for fields and variables 
is the same as the data type specified 
for that data unit in its data declaration. 
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The format of the output is specified 



below. 

Data Type Format 

A 120.8 

I 120.8 

B The integer or 1 

S The status constant 

name 

F E20.8 

H Aw (w = number of 

characters) 



V(x t y) Optional. Specifies the magnitude for 

conversion for a field or variable. The 
magnitude must not exceed 15 bits. 

Examples 

i. ^\ l \ 5 A L \ A ff\ Kji iM i 4\ I i I I I i i M I I I I i ) i I I l I i 

Assuming M is a 4 -word table, X is a Hollerith variable, and Y is a 
floating-point variable, the printout might appear as follows: 

M 046732115043 

362341023456 

265123245675 

145676343210 
X DOG GONE 
Y 0.34244632+07 
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2. iflgfl*i.A/lSlAil/?i/ .iT x MU\fixLf\lhAi^F&^x & 



I I I I I I I I 



Assuming FIELD is an arithmetic field, the printout might appear as 
follows: 

BETA 

TABL( ALPHA , FELD) 432.06 



m&bE i VJ iZ ill 4i 


1 ! 1 1 I 1 1 ! 1 1 I 1 1 1 1 1 1 1 1 1 1 


.ifilid'Ufc |S|P£|E1>, J, ,£,0, M 


)p\ I-Ml f#l 1 1 1 1 1 1 1 I 1 1 1 1 


|f|"|2»|-|Ti/»|B|LC| ft | | 


1 1 1 1 1 i 1 1 1 1 1 1 1 1 1 II 1 1 


1 1 1 1 1 1 1*1 1 1 1 1 1 II 1 1 


1 1 1 1 1 1 I 1 1 1 1 1 1 1 1 1 1 1 1 


1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


1 1 1 1 1 t 1 1 1 1 1 1 1 1 1 1 1 1 1 




i i i 1 1 I 1 * 1 1 l I J 1 I 1 I 1 l 


1 1 1 1 1 1 1 I 1 1 1 1 1 1 1 1 1 1 1 


. 1 1 l 1 1 l # l 1 1 1 1 1 I 1 1 t 


1 1 1 1 1 1 1 I I 1 1 1 1 1 1 1 1 i . J- 



2 9 2 8 2 7 2 6 2 5 2 4 2 3 2 2 2 l £ 















1 





1 












31 14 



3C3 

o 



Field 

Bit 
Fosi tion 



2 

'A 
2 4 

2 6 

2 7 
2? 



Magnitude 
Represent ed 



I 0.15625 
I 0.3125 

0.625 



i i- 

I 2.5 

I 5 

I 10 

j 20 

I 40 

I 80 
I 
I 
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Assume that the field SPEED had bit settings as indicated in the 
illustration above. To execute the display statement with the con- 
version specification that bit 2^ of field SPEED represents 40, the 
output would be: 

KNOTS 

NAV(O t SPEED) 6.25 

5 3 

where 6.25 is the summation of the binary bit values of 2 and 2 
(5 + 1.25) respectively. 

8.2 SNAP STATEMENT 

The SNAP statement reserves an area image equivalent in size and attributes 
to the data unit. The first execution of the SNAP statement causes the contents 
(or converted value) of the data unit to be printed on the system output device 
and stored in its reserved image area. Subsequent executions of the statement 
cause a printout only if the contents of the data unit have changed. 

Format 

name SNAP image V(x t y) $ 
Explanation 

Name Optional. An identifier for this state- 

ment. If included, this identifier must 
be followed by a period and is printed 
with the data unit and its contents. This 
name is not a statement label and therefore 
may not be referenced. 

Image An identifier for a table, subtable, like- 

table, item-area, field, or variable. 

The image output format is the same as 
that described for DISPLAY (see paragraph 
8.1). 
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Vvx.y) 



Examples 



Optional. Specifies the magnitude for 
conversion for a field or variable. The 
magnitude must not exceed 15 bits. 



1. iii i i i t i \S\E\Z 1X1 |T,g, i Vl i^l A\ t$\ i i i 



I I I I I II 1 
I I I I I I I I 



S\H\hP\ X\ ffi i 1 i i i I i i i i i I i i i i 



1 111 I I I I 



I II II 



I I I I I I I I 



I I I 



ftflTt/li.i i i 1S.A/./I.P. .T,^,fi,Li(iJ, JI F,£|/Lj)|), ft 



I 1 I I I I I I 1 



6iAiMiMi/?i«< . |5iE t T, jX, ,T,o, gq+,1, 



I I l I I 1 I I I I l I I I 1 



This example illustrates several aspects of SNAP statement usage. In 
this example, snap ALPHA is always executed, while snap BETA is executed 
only when Z is less than or equal to 0. The IF statement serves only 
to place a condition on the snap; deletion of the SNAP parameter on the 
DEBUG header would render the IF statement unnecessary. These same 
considerations also apply to the use of the DISPLAY statement. (Note 
that the debug statements should not be compounded.) 



2. 



HiffiDlLibl i/V|fllV, IV. IX.. lil |», 1 , , , , 

.hhf.Liii -iC|0|«i*,siffi iX, S\ iUI .1, ,M 


i i i i i i i i i ii i i 
i tin i 1 i i i i i i i 


iiii 
i i 1 i 


i^ibi-iTiAi6iUC. 1AM1V1 i , 1 , , , , 


i I i I I 1 I i I 1 I I 1 


i ili 




Vita6i0Li?i)i \t\ i i 


ill. 



At the time the SNAP is first executed, assume the bit configuration 
for COURSE is as follows: 







31 



19 



11 



The output would then be: 
CRS 

NAV(0; COURSE) 33.75 
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which represents the summation of the binary bit values, as specified 

3 2 

by V(360,14), of 2 and 2 (22.5 + 11.25 respectively). See paragraph 
0.1, Example 3 for a detailed explanation. 

8.3 RANGE DECLARATION 

The RANGE declaration specifies that a data-unit value is to be 
determine whether it exceeds the values specified each time the 
set. This declaration can appear only within a data design. 

Format 

data-unit-name RANGE value 1.. .value 2 $ 
Explanation 

Data Unit Name A variable or field (floating-point, fixed-point, 
or integer) . 

Value 1 The upper limit for this data unit. 

Value 2 The range separator, used only if value 2 is specified. 

NOTE 

Only one RANGE declaration is allowed 
per field or variable definition, If 
the RANGE declaration references a 
field, the declaration must be placed 
within the table brackets. 

Examples 

i. frihSiTiAif/iCiEl 6iYi«Ui»i8i rfn i i i i 1 i i i i | i i i i 1 , 

Each time data is set into the data element DISTANCE, the range is tested. 
If at any time the value is outside the range of 64 to 8, a printout to 
that effect is made similar to the following: 

DISTANCE EXCEEDS RANGE AT CALC +2 

where CALC is a statement label and the statement causing the range to 
be exceeded occurs two statements after CALC. (For the purpose of 
statement counting, both the THEN separator and the $ terminate a state- 
ment . ) 
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1 1 1 1 l 1 1 1 k |0|C|-i^l2j, i^i i 1 | i ill | | | | | 1 I I 1 1 I I III . 


1 1 III 1 1 1 


r^iSjLiei iTiAjBiL 


ittl I^J itl £l 1 


1 1 1 II 1 1 1 1 1 




I I 1 111 II 


F [ i iFiLi^bi .F t £,u,J>r ,1, jSi M\'\L 


4 ill 4i i i i i i 


1 ,. 


1 1 1 1 1 1 1 1 


\F£LU JMiMiAA 3\L\(k.\.\.\& .4 


1 1 1 1 1 1 II 1 


1 


i i i i i i i i yT\JU/?r\T\A6iliF\ 


T\A\AL\ A i i i iii i m m i i 


MM 1 1 1 1 


riViiritiO,Ci-|l|J| *i i i i i i i i 


III II III I 


1 


M l l 1 i I 1 


P iRiOiCi Ei^iM f R,E| 


I^iMiHiPiRiOiCi ft 


1 1 1 1 1 1 1 II 


1 


lilUlMllllni 1 


ViAi^iyi 1X1 iwimt 


*|/|A/| iTMlfilLl A 


MINIMI 


1 


Ml HI H 




i\ F \ £ \ L \*\)\ l r l°l 


Xi 1*1 |Y| l$l I I 


1 


1 1 1 Mill 


^iM.L,!, | 


* 1 1 1 1! 1 1 1 1 


1 II 1 1 1 1 1 1 1 



If any occurrence of field FELL) in table TABL is within the range, no 
message is printed out. If FELD is outside the range of values, the 
printout might appear as follows: 

TABL (4, FELD) EXCEEDS RANGE AT DUMLI+1 



i i i i i 1 i i VifliftLi iX i S i/ 


\U\ i$, i l 1 i i i i I M 1 1 i 


i 


i i i i i i i i ViRiBiLi iy, iAi i/ L\ \U\ i^i i i i i i i i i i i i I i 


iXl i i i i i i % ift\*l\6r\E\ i &\&\ i i i i i i i i i i i i i i i i i i 


i i i ] i i i ] ii-iO,cr,Jii i^i i i i . i i i 


i i i i , i i i i i 


, PifliOiCiO.M,?, P.R^.cA ^, , , 


i ii i i i i i i 


. i 


iM.B.ii.i , , 


SifiTi ,T|0, iY 


+l7l I^M 1 1 1 1 


i i i i i i i ii 





If X is greater than 38, the printout might appear as follows: 
X EXCEEDS RANGE AT LAB 1+0 
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0.4 TRACK STATEMENT 

The TRACE statement generates a line to be printed on the system output device 
for each executed statement that occurs between the TRACE and END-TRACE state- 
ments. This line identifies the flow of execution by the most recent statement 
label plus an increment of statements relative to this label. The Compiler 
counts statements whenever a $ or THEN is encountered. The statement immediately 
following the TRACE statement should be labeled. 

Format 

TRACE $ 



dynamic statements 



END -TRACE $ 
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Example 



i i i l 1 



iT,l?i/Hc,£ <6 



ii i i i i 



1 



AA.l., ,s,g,rl gi ,T,0, X, ,+, I/, 



I I I I I I I 



I I I I I I I I I 



I I 1 I I I 



S | g | Tl- | Y | , T , Q , , Q , 



II II I III I 1 I.I I 1 I II I 



,ix, ,z, ,6,<ar,o, aall i 



i i i i i 



i i i i i i i i 



i i i i 



I i W l | X | | T , Q , , , 



i i i i i i i i i I i ■>■ i i i i i 



i ill i ii 



ii I I I 



i/iFi IPifliri/h iA/|g>iTiffQlUi/ViJ)i iTiHifiA/i &\Q[TO\ iGClli i$l 



l^l £ |Tl |T|Q lYl |t| 1 11 i $ i I I I 1 I 1 I 1 I 



I I I I I I I 



I I I l i l * i 5'S|li i M | £ | |B | E | i i | 4| 1 i i | | i | i | i 1 i | | | i | i | i 



I I I i I I i I i 



i li II Ml 



l l I I 1 I 



g i^hiT | ^ | ^ | C i £ i fa 



i I i i > i i 1 iii I i ii iii i ii 



Assuming that Y is and there are two occurrences of X in field FELD 
of table TABL, the printout might appear as follows: 

AA1 + 
AA1 + 1 
AA1 + 2 
AA1 + 3 
BB1 + 
BB1 +1 
BB1 + 3 
BB1 + 4 
BB1 + 
BB1 + 1 
BB1 + 3 
BB1 + A 
BB1 + 
BB1 + 1 
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BBl 4 2 
CC1 + o 

If in the above example Y is not and there are no occurrences of X 
in field FELD of table TABL, the printout might appear as follows: 

AA1 + 

AA1 + 1 ^ 

AA1 + 2 

AA1 + 4 

BBl + 

BBl + 1 

BBl + 2 

CC1 + 

8.5 PROCEDURE TRACE (PTRACE) 

The PTRACE parameter on the debug header provides a mapping of procedure 
linkages by printing a message for every CMS-2 procedure call encountered. 

Format 

PTRACE 

Example 

l.aWfi, ,RT,M.c.g,$, , 

Printed output shows the current procedure name and the called procedure 
name at. each procedure call as follows: 

PROCEDURE xxxxxxxxxx CALLING PROCEDURE yyyyyyyyyy 

where xxxxxxxxxx is the current procedure being executed and yyyyyyyyyy 
is the procedme to be, executed. 



II-8-11/II-8-12 Blank 



M-5035 

Change 2 



SECTION 9 
DIRECT CODE 

Direct code statements, or symbolic machine code instructions, are operations 
which generally result in the generation of a single machine instruction. 
The CMS-2 Compiler processes as direct code, a subset of the language defined 
for the CMS-2 Assembler (see Sections 11 and 12) . This direct code may appear 
in both data designs and procedures, but it must be properly bracketed and 
must follow a specific source card format. 

The remainder of this section describes the direct code statement format, the 
various directives available, and specific processing conventions. In 
addition, this section describes the differences between the direct code 
subset that may be embedded in a CMS-2 program for processing by the CMS-2 
Compiler and the full assembly language capability available through the 
CMS-2 Assembler. 

9.1 DIRECT CODE STATEMENT FORMAT 

When one or more direct code statements appear in a CMS-2 source program, 
they must be bracketed between two CMS-2 statements provided for that purpose. 
These statements are described below. 

DIRECT $ Must immediately precede a sequence of 

direct code. 

CMS-2 $ Must immediately follow a sequence of 

direct code. 

The format for direct code statements apprearing in a CMS-2 program is slightly 
different from that accepted by the CMS-2 Assembler. The format is consistent, 
however, with that of CMS-2 source cards in that card columns 1 through 10 are 
strictly for programmer use and are ignored by the Compiler. The normal 
direct code format consists of three fields delimited by spaces and commas. 
Periods indicate the end of a coding line. Direct code statement is limited 
to one card. The general card format is illustrated below. 
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Format 



CARD-ID label op-code operand 



Explanation 



Label 



Instruction label. Always starts in column 11 



of a coding line. A space in column 11 indicates 
no label. A label may consist of at least one 
but not more than eight alphanumeric characters ; 
the first character must be alphabetic. It must 
not be followed by a period. 



9.2 DIRECT CODE STATEMENT REPERTOIRE 

The CMS-2 Compiler will accept the full AN /UYK-7 machine instruction repertoire 
as defined in Appendix G. A more detailed description of these instructions 
may be found in Section 12. 

In addition to processing the symbolic machine language repertoire, the CMS-2 
Compiler will accept several Assember directives and a variety of expressions 
and constants as operands in the direct code statements. 

9.2.1 Direct Code Directives 

The following items define the CMS-2 direct code directives that are processed 
by the CMS-2 Compiler. 



Op Code 



Separated from label field by at least one space. 
May contain a mnemonic function code. A space 
signifies the end of the op-code field. 



Operand 



Contains the elements of the function specified 
by the op-code. Operand fields are separated by 
commas. Line termination and comment fields are 
acceptable and are indicated by a period followed 
by a space. 
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ABS 

F ormat 

label ABS label 
Explanation 

ABS Translates compile-time location counter value into an 

object-time absolute address. 

BYTE 
Format 

BYTE e lt e 2 

Explanation 

BYTE Redefines the embedded character size and number of 

characters placed in an object word for direct code 
character strings occurring subsequently within the 
same CMS-2 element. 

e^ The number of characters to be packed into an object word. 

&2 The size of the character field in bits, not to exceed 

16 bits. 

CHAR 
Format 

CHAR C, , e. , C ol e . . .C f C 

lied, n n 

Explanation 



C^ The octal code (000 through 377) that is to be redefined. 

e. The redefined value where current character e. becomes 

l l 

new value e. . 
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4. DO 

Format 

label DO e f direct-cons tant-ent ry 
Explanation 

e An integer defining the number of times the direct constant 

is to be generated. If a label is specified, it shall 
apply to the first word of generated data. The direct 
constant entry must not contain a symbol. 



5. FORM 

Format 

label FORM e.,e ...e 
12 n 

Explanation 

FORM Describes a special word format specified by the 

programmer. The word format may include fields of 
variable length, where the length in bits of each field 
is user-defined. 

e. The number of bits in a user-defined field. The total 

i 

number of bits must be equal to or less than 64 and 
the number of such subfields limited to 16. e^ must be 
less than 32. 

The FORM directive may be implied. The format for utilizing the implicit 
FORM is illustrated below. 

Format 

N r N 2 ....N n 
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Only constants are accepted in Form reference sub-fields with the exception 
of a name appearing in the last sub-field where that sub-field size is defined 
as 16 bits or greater. When a value appearing in a Form reference sub-field 
requires more bits than was defined in the Form declaration the leftmost bits 
of the value will be truncated when packing the resulting constant. 



Explanation 



N 



Values to be packed into fields of word. The Compiler 
determines the number of bits required to contain each 
value by dividing the word into n fields and forming 
the word accordingly. 



6. RES 
Format 

RES e 
Explanation 
RES 



Adds the value of the single expression in the operand 
field to the current location counter value. 

An expression that must result in a determinable 
positive value. 
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9.2.2 C onstants 

Constants accepted in direct code statements are: 

1. Decimal numbers. 

2. Octal numbers . 

3. Floating-point numbers. 

\. Double-word-length octal numbers. 

5. Double-word-length decimal numbers. 

6. Character strings from one to eight characters in length. 

7. Scaled decimal numbers. 

Constants may be used in direct constant entry statements and in direct code 
expressions. The following paragraphs define CMS-2 direct code constants. 

9.2.2.1 Decimal Numbers 

A decimal number is converted to its binary equivalent and used in its binary 
form for all computations. The integer may consist of 9 digits if single 
word and 18 digits if double word specified. The sign of the number is the 
leftmost bit of the final object word. The first (most significant) digit 
of the coded decimal number must not be 0. If the decimal number is immediately 
followed by the letter D, a two -word binary equivalent will result. 

. Example 



.-,/■& , , I*. .PIR.QlW.c.c.S, flq r.fr I, ,37,7,7,7,717,7,7,^7; , , , , 



i i i i i i 



i i i , i ■ , , i I i ■«, t/*,^tJ>i i i I , ■ i PiO|O i oac|0,o i oiOiq i i i i I 
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9.2.2.2 Octal Numbers 

An octal integer is specified by preceding the first (most signficant) octal 
digit with a 0. Each character of the octal integer must be an octal digit 
(0 through 7). Rules for evaluation are the same as for decimal numbers. An 
octal number may also be followed by the letter D to obtain a double-precision 
result. 

Example 

rhfl*r3, i i«i iPlfio.M.Cj&S, CiO^OiOOCOiOl^ I . , , i i , i . i 1 
rft3i*ft »«i iP|*A3»ft|C,g|S» i3|7|7|7,7,7i7i7rfi2i/i I i i . . i i i i i I 

i+pv^mMiloitaM ,., ,p l rioifttf,6i6i& 3AistoiSAiAi*3i . 

i j i I i l l i I I l i 11 i i»i iMA i I I I I 0P\OlOiO\QPPPP\l\ I 



9.2.2.3 Floating-Point Numbers 

A floating-point number must be coded as a single word decimal mixed number 
consisting of an integral part and a fractional part, and must include the decimal 
point. Spaces are not allowed within the number. The number is converted to a 
64-bit floating-point number, formatted in memory as follows: 



SI |30|29|28]27|Z6[2S]24(23[22(21 1 20| 1 • 1 1|| IT 1 1«| IS 


I4|l3|l2|ll|l0|»|a|7|«|3|4|s|t| 1 |o 


Sign of characteristic 


Characteristic 



SI 


SO|2*|2t|27|2t|tS]24|2S|t2j2l|ZO|lt|l«|l7|l«]l9|l«|l3{l2|ll|lO| t | •|t|6|5|4|3|2|i |0 


S 


Mantissa 



where S is the sign of the mantissa. 
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Example 





iPiRiOiD,UCiSS[ 00xOiO&O0<hCiliL\ i i i i i i i I 


111 1 I I 111 1 •! 


AHk i i i . i ,l'M*£t*t1iPPPfii i i i iii i I 




A m0il)MCFi2i ^mo&piO&ogim, . I . i i i i I 


,11111111 »| 


\WA i i i i I iViWi i i i i i i i I 


I+|I|0|.|O| 1 1 1 


\P\R\ PP\ C F\S\ AWi°i°iWh1r i i i i i i i I 


111 1 1 II 1 1 I'l 


.fl.AU* mil UAOMopaqcp, 


riii'A n n *i 


.flKAD.U.Gfc'Sl AQOfipfi&Ofifa U i i i i i i i I 




i i n l MmW\W?\ i i i i i i i I 


i n«i3i. i i i i *i 


iflUftlMCeSI 3,7,7,7,7,7,7,7,717,6, , , , , , , , 


i i i i i i i i i i 


AiVlA t i i i 1 A*3,/,fli*-AMI*i3|-| i i i . i , 1 



The * + and * - operators are accepted when declaring a floating- 
point constant. 

9.2.2.4 Character Strings 

When a + precedes a character string, the Compiler regards the string as a 
constant; therefore, the number of characters between apostrophes may be from 
one to eight. One to four characters yield one computer word; five to eight 
characters yield two computer words. Characters are packed, right-Justified, 
within the generated words with leading binary zeros as required to pad the 
word. The implied code for character strings in ASCII. 

Example 

ft-, ,'d.CftC,'. I ■ , ... .P.RO .B.UlCfiS ■/■Q/^^l-S/.AOiiT i i i i I 

■ ♦. , , l A 1 c,ftg,A,6te, / , ■«■ ,p,R.ai> .mcss ■oaoAo.W.s^ , , , , i 

1 i i i i i i i i I i i 1*1 i i i i i I i i i i/ A^^iS^iii i l i i I 
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9.2.2.5 Scaled Decimal Numbers 

A decimal or floating-point number followed by a */N shall be handled by the 
Compiler as a scaled, fixed-point value. The form of scaled numbers is shown 
below: 

Format 

Nl*/N2 

Explanation 

Nl May be a decimal or f loatiny-poin t number. 

N2 Shall be a decimal number. 

The converted decimal number shall be aligned to a scale value indicated by 
N2. 

Example 



ififl-^rfi/i-ia h ]P/xmucf\& \on<XY&QQidQ/\ i 1 1 1 1 1 1 
\t&*/& i i i i»i iAB^/^giftsi i^yw^/^ i i i 1 1 i 1 1 



9.2.2.6 Scaled Octal Numbers 

An octal number followed by a v*/N- shall be converted and shifted as specified 
by the scale value following the "*/" indicator. The compiler will not test 
the scale value for overflow but will simply perform a left shift circular 
or right shift sign fill by a number equal to the scale value. 
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Format 

Nl*/N2 
Explanation 

Nl Scaled octal number 
N2 Decimal number 

If N2 is signed negative, Nl shall be converted and shifted right N2 bits. 
If N2 is unsigned or positive then Nl shall be converted and shifted left 
N2 bits. 

Example 



I I I- I I I I I 

I I III I I 

*tt3*fl»t/Lg/i i ui igflofv^ifl^l i2i<yy?iry?iiW}h? > ■ ■ ■ ■ ■ ■■ ■ 

I iiflKftM-ia I l«i lABftCK/tfYffl ^I7\7\7\7f7\7\7mt i i i i i i i I 



i+flrfifliOi/l-iA 1. 1 iABQfl£i>Qflgl I 



9.2.3 Data Expressions 

The data expression forms that are accepted by the CMS-2 Compiler are defined 
below: 

1. Constant (as defined in paragraph 9.2.2). 

2. Numeric tag (identifier assigned a value by equals statement). 

3. Operand 1 -operator-operand2 (operand2 must be a constant in this form). 
The operators allowed within data expressions are: 

1. + (addition) 

2. - (subtraction) 

3. * (multiplication) 
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4. / (division) 
Mixed mode constants are not permitted in data expressions. 

9.2.4 Literals 

A literal in CMS-2 direct code is defined as a data expression contained 
within parentheses. 

Examples 

(56) 

('CAT') 

One or two object words result from evaluation of a literal. Data expressions 
allowed in literals are defined in paragraph 9.2.3. 

9.2.5 Direct Constant Entries 

The CMS-2 Compiler accepts data words declared in direct code that result in 
one or two generated computer words. Character strings may require more than 
two words. These direct constant entries shall consist of declared constants 
as defined in paragraph 9.2.2, character strings, or data expressions. 

A + or - sign in the operation field followed by one or more subf ields in the 
operand field signifies that a constant is to be generated. Whenever a + or 
- sign appears as the first character of the operation field, any number of 
spaces or no spaces may separate the sign from the first operand. Subf ields 
are separated by commas. In generating constants, the Compiler uses the size 
of the object computer word. If the operand field contains one subfield, the 
signed value of the subfield is right-justified in the generated word. If 
the operand field contains two subf ields, two equal-length signed subf ields 
are generated with the values right-justified within each field, and so forth. 
The first subfield must be signed. Successive subf ields may optionally be 
signed. The absence of a sign implies a positive value. If variants of this 
implicit equal subdivision of data words are required, the capabilities of 
the FORM directive may be used to derive the desired format. This is 
accomplished by referencing the FORM label in the operation field. 
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Examples 

i .-/.*■ i i I i i i AWMU&Cfr .3,7,7,7,717,3,7,7,7,7, , , , [ 

If the operand field contains just one subfield immediately followed 
by a D, or if the constant is a floating-point number, the Compiler 
generates a double-length constant in two successive computer words. 
The first generated word of the double-length constant will contain 
the least-significant bits of the result. The letter D in this 
context is only meaningful when appended to a numeric constant. 

a ■+■ >IP,*A lP,toJ>M,C £& ,0^000,0 000041 I 

i i i i i i i i *i I i i i i / U,O,0,O|O|QOppfi| .i,,,,,,, 

■■-Maaflfoi iPiRi QftmciSS JI7.7, 7,7,7,3,7,7 ,7,71 ,,,, . mil 
i i i |- i i i i*i I i i . i i i i i i ( 3|7,7,7,7|'/| 7, 7,7,7,71 ,,,,,,,,, I 
i^<V,Wii£i 716,^*1 Wj), i.i lflR,<V>i«,C5Si ,3M,r^i7itfi^i^/ 
1 i i i i i i i i I i i i i i i i i*i I i i i i i i i i imoPPPPiWft 

Character strings longer than eight characters may be entered as a 
direct constant entry. No character string in CMS-2 may exceed 132 
characters . 

9.2.6 Instruction Expressions 

The CMS-2 Compiler recognizes and processes simple expressions appearing in 
the operand field of direct code instructions and in direct code directives. 

Expression forms allowed are: 

a. Symbol (label, tag, $). 

b. Symbol + constant - If symbol-constant is used and the symbol is 
externally referenced, see note at end of section 11.3.3.12. 
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c. Constant + symbol. 

d. Constant. 

e. Literal. 

A constant used in an instruction expression must be limited to a decimal 
octal integer. 

The $ symbol is used only to reference the Compiler location counter. The 
contents of the location counter are accessed by coding the symbol $. $ 
signifies that the contents of the location counter are to be substituted 
the expression. 

Example 

1^1 I 1 I I I H I fo f A I l i I I l l»l I I I I I I I l I i i .. i 

An alphanumeric label may be used within an expression. The label 
must conform to the rules for labels as described earlier; for 
example, it must not exceed eight characters; it must consist of 
alphabetic (A through Z) or numeric (0 through 9) characters and 
the label must begin with an alphabetic character. 

When the expression is evaluated, the value allocated to the label is sub- 
stituted in the expression. Numeric constant values may be equated to 
labels by the CMS-2 high-level declarative EQUALS for use in direct code 
expressions. The high-level EQUALS statement allows simulation of the 
parenthetical static expression capability in direct code. 

An identifier that has a value assigned by an EQUALS statement is defined 
a tag. 

Example 

1/rtiZiTi )fMM£\?\ .7i.ifi ift i i I i i i i i i i i i 1 i i i i , 

The tag VALI can be used in a simple expression carrying an asso- 
ciated value of 7.5 when the expression is evaluated. 
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A symbol defined by a high-level MEANS or EXCHANGE statement may be referenced 
in direct code. However, the character string to be substituted for the 
symbol in the direct code is subject to the following restrictions: 

a. The character string may not contain a comma or a period (i.e., it 
must represent a single term of a single direct code statement). 

b. The character string must be equal in length to the symbol, it re- 
places in direct code. 

NOTE 

Character substitution for a symbol defined in an EXCHANGE 
statement will be performed for the purpose of statement 
interpretation. However, no source card or listing editing 
is performed. 

Example 

JlX. i i jMjEtMlSi M &\ i I i I » it i i i I l i I 1 I I I I I I l I I 

\?MM\ tS^lM^.fi .W.lii I I I , I I I I I I , » I 

1 » l l I. I I » 1*1 1 I 1 I I I 1 I 1 1 i I i I I I 11 1 I I I I I I I I I I 1 

I II 1 I III 1*1 II I M II I I 1 I I I I I I I I I 1 I M I I I 11 I I 

i 1 I I I ■> I i VI I f I 1 f i I M I 1 i i I I I. I I l I I I I I I I 1 l I I 

AEfo^T I* I I I I I I- I t I I I 1 I I I I I I I I I I I I I I I I I I I I 

\ L A i I i foftiMfiftflyiW i*l i i i i i i I i i 1 i i i i i i i i i 1 

A i 1 i i iiii i n l i i . i 1 1 i i i I i 1 1 i i i i 1 1 I 



The direct code statement would be assembled by the Compiler as: 
LB B4, TAG 1 1 , K3 
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9.3 PROCESSING CONVENTIONS 

The following conventions apply when processing direct code statements appear 
ing in CMS-2 programs: 

a. Direct code statements, bracketed by DIRECT and CMS-2 may appear 
within the following source program elements: 

1. Procedures (PROCEDURE). 

2. System data designs (SYS-DD). 

3. Local data designs (LOC-DD). 

b. The rules established for referencing labels within or from 

outside procedures and data designs apply to direct code 
segments. The direct code statements assume the same refer- 
encing and allocation characteristics as the program element 
within which the direct code resides. 

A direct code statement may be declared to preset a data unit 
defined in a high-level declaration. The direct code statement 
must be labeled with the duplicate of the identifier of the 
high-level declarative and must not precede the high-level 
declaration. It must be given within the same data design. 
Any direct code following the preset of a high-level data 
unit is assumed to be part of that preset unless labeled ' 
by an identifier duplicating another high-level definition. 
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Example 







1 1 1 1 1 1 ! I 1 1 1 1 1 1 1 1 1 


i i i i i i i i i Ii/i£i2Ui M/lWiii £11111111 1 * 1 > 1 1 1 


II Mill 




1*1 II II 1 1 1 


1 1 1 1 1 1 1 1 1 1 1 ( 1 1 1 1 1 
_1 11 .1 I 1 1 1 I 1 1 1 1 1 1 1 1 


LI 1 1 1 1 1 1 1 




M 1 1 I 1 1 1 1 


1 1 1 1 1 1 ! 1 1 1 II 1 1 I I 


L-..LI I I 1 I N 




1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


1 1 1 1 1 1 l 1 1 




1*1111 1 1 1 1 


I 1 1 I 1 1 1 i 1 1 1 1 II II 


1 1 1 1 1 1 1 i 1 




1*1 1 1 1 t 1 i i 1111111 


1 1 1 1 1 i 1 1 1 




„ 1 '.1 1 1 1 1 i 11 


1 1 t 1 i 1 1 1 1 1 1 1 l 1 1 1 


111 1 t 1 11 j 


, 1 J .J, i .1 J, i 1,1 ., 


1 1 I 1 1 1 t 1 1 I 1 1 1 1 i 1 


1 1 1 1 1 1 1 1 1 




1 .1 ,.,i,..i i r 1 ,1 ,1 . 


> * ill 1 ill 1 1 i 1 i 1 1 


L_i.i ..i,.J...l.J-L-i 






. ,£.XAMP.2..6 X , .1,, 



The computer word to which the variable NAM1 is allocated will be 

preset to the decimal number 625 declared in the low-level direct 
constant entry. 

c. Direct code segments may reference other direct code segments 
resident in the same SYS-PROC or SYS-DD. 

d. CMS-2 high-level statements may reference direct code statement 
labels (GOTO or SWITCH only). 

e. CMS-2 high-level statement may not reference data units defined 
only by direct code statements. 

f . Direct code statements may reference data unit names (symbolic 
addresses) defined by high-level declaratives. K-designators 
must be coded explicitly. 
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h. 



J. 



Direct code statements may reference high-level statement labels. 

The rules of symbols, operator priority, and elements established 
for direct code statements are independent of those applicable 
to high-level statements. 

The following mnemonics, used to reference computer registers, 
are recognized by the direct code processor: 

1. Accumulators: AO, Al, A2, A3, A^A5, A6, A7. 

2. Index registers: BO, Bl, B2, B3, B4, B5, B6, B7. 

3. Base registers: SO, SI, S2, S3, S4, S5, S6, S7. 

4. Quarter-word memory: Ql , Q2, Q3, Q4. 

5. Half-word memory: L t U. 

6. Whole word memory: W. 

7. K-designators: KO, Kl, K2, K3, K4, K5, K6, K7. 

Direct code half-word instructions are packed together into one 
word where possible. Labeled half-word instructions will 
always be assigned to the upper half of the word. The following 
tables illustrate the method for packing half-word instructions 
(HW = half-word instruction, FW = whole-word instruction) : 

Instruction Memory Assignment 

1. Nonlabeled: 



HW 



HW 



FW 



FW 



HW 



HW HW 



HW 
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FW 

HW HW 

FW 
HW 

LABL1 HW 
FW 
HW 

LABL2 HW 
LABL3 HW 

k. Spaces appearing between elements in operand fields of direct 
code statements are ignored except where specifically defined 
as a delimiter, as illustrated below: 

MOD + RAD Spaces ignored. 

M OD + R AD Illegal because of spaces within 

element itself. 

1. Labels of direct code in system data designs are treated as 
global labels by the Compiler. 

m. When referencing procedures declared by high-level statements, 
the direct code instructions must be the same as the instructions 
generated by the Compiler for a high-level procedure call. 

n. A direct code statement that contains an explicity coded s- 
designator (base register) may contain only a constant in the 
Y-field. 

Table 9-1 summarizes the values and symbols that may appear in direct code in- 
struction subfields and in direct constant entries. 



2. Labeled: 
FW 
HW 
HW 
FW 
HW 

LABL1 HW 
FW 
HW 

LABL2 HW 
LABL3 HW 
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Table 9-1. Instruction Sub-field Valid Forms 



^ . a y k b s ak af4 sy m/b 1 w p e DCE Lit 

1) Octal digit x xxx x 

2) (1-4) x xxx x 

3) "L" (=1) x xxx x 

4) "U" (=2) x x x x x 
"W" (=3) x xxx x 

6) A, B t C, I), H, K, 

S (0 - 7) x xxx x 

7) NTAG (=0-7) x x x x x 

8) MEAN/EXC (2)-6) above) x xxx x 

9) Integer £ 177 x x x x 

10) NTAG (1177) xx x x 

11) "ALL) (= 177777) x 

12) C(0 - 17) x 

13) Integer £ 177777 x 

14) NTAG ^ 177777 x 

15) Y operand $ Y x 02 

=r i 

16) Inteqer -77 x <Q 2 



17) + Integer or Integer 



Table 9-1. (continued) 











a y k b s ak af4 


sy m/b 1 w p e 


DCE 


Lit 


18) 


Integer + Relocatable 
Identifier 


X 








19) 


Relocatable Identifier 
+ Integer 


x 








20) 


Relocatable Identifier 


X 








21 ) 


$+ Integer 




X 








22) 


Literal: 
NT AG, data 


(Constant , 
express. ) 


X 








23 X 


NTAG 






X 


X 


X 


X 


24) 


MEAN/EXC tag 


X 










Constant 






X 


X 


X 




Const 


+ 














Const ( 


* 

./. 
no 


mix) 




X 


X 


x 


27) 


Char String £132 chars 






X 




28) 


Integer 


<37777 (BCW) 
14000 (BCWE) 




X 
X 







RTAG - Identifier equated to identifier. 
NTAG - Identifier equated to a value, 
e - data expression 
Identifier - includes RTAG 
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The following Items identify additional capabilities available under the CMS-2 
Assembler which are not included in the direct code capability of the CMS-2 
Compiler. 

1. Addressing section declarations in the label field are not 
allowed (direct code is compiled under the existing high-level 
allocation environment). 

2. Macros and related directives are not allowed (including macro 
name and statements, paraform usage, and macro reference lines). 

3. Library retrieval from direct code is not allowed. 

4. Labels of direct code externalized by postfixing an asterisk 
to the label are not allowed. 

5. The CMS-2 Compiler does not process direct code statements 
containing expressions using parentheses. 

6. The following directives are not acceptable as direct code: 

a. END 

b. SEGEND 

c. LINK (can use the high-level EXTREF statement instead) 

d. Loader directives (*AC, *CS, etc.) 

e. LLT 

f. LCR 

g. LIST, EL 1ST, and NOLIST 

h. ODD and EVEN 

i. PXL 
j . WRD 
k. RF$ 

1. EQU (can use the high-level EQUALS statement instead) 

7. SET ADR and LIT literal directives are not allowed (the Compiler 
controls when and where to dump the literals). 
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SECTION 10 
COMPILER OUTPUTS 

A variety of hardcopy or listed outputs is available from the CMS-2 Compiler. 
The method of selecting these various outputs using the OPTIONS statement is 
described in Section 7. The purpose of Section 10 is to explain the various 
listing formats, page headers, and column descriptors. 



10.1 SOURCE LISTING FORMAT 

The source listing provides a record of input to the Compiler. This listing 
consists of a page header for each listing page containing the element name 
and number, the date of the compilation and a page number. 

If the source listing is requested by a SOURCE option and no OBJECT option, 
the format is as follows: 



Column Heading 
CARD ID 

SOURCE STATEMENT 



ERROR CONDITION 



Meaning 

Columns 1 through 10 of the card 
image. 

Columns 11 through 80 of the card 
image (the CMS-2 source statement 
field). 

An error message for any syntax 
errors detected in the source state- 
ment. 

If the source listing is requested by a SOURCE option and an OBJECT option 
(no SM), the body of the listing consists of several columns, the contents of 

which are explained below. 

Column Heading Meaning 

ERR Used to indicate errors that occurred 

in the adjacent source statement. A 
list of these errors, their meanings 
and identifying numbers that appear 
in the error column is given in 
Appendix E. 
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S 

AC 
LOC 



LABEL 



STATEMENT 



CID 



SID 



CR 



Base register number. 

Address counter number. 

The relative memory location (in 
octal) of the first instruction or , 
data word generated for this state- 
ment. 

The label associated with the source 
statement or the first 10 characters 
of the input statement. 

A character field containing the 
remainder of the CMS-2 source state- 
ment. 

Four characters of the card ID 
(columns 1 through 4). 

Four characters of the card ID 
representing the statement number 
(comumns 5 through 8). 

The remaining two characters of the 
card ID. 



10.2 SOURCE AND MNEMONIC LISTING FORMAT 

The source and mnemonic listing (SM) provides a record of the source 
input to the Compiler as well as a side-by-side mnemonic and octal representa- 
tion of the machine instructions generated for the source statements. This 
listing consists of a page header for each listing page containing the system 
procedure or system data-design name, the date of the run, the number of the 
element being compiled, the page number, and the type of element. The body 
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of the listing consists of several columns, the contents of which are 
described below. 



Column Heading 
ERR 



S 

AC 
LOC 



FUNCTION 



LABEL 



STATEMENT 



CID 



Meaning 

Used to indicate errors that occurred 
in the adjacent source statement. A 
list of these errors, their meaning, 
and identifying numbers that appear 
in the error column is presented in 
Appendix E. 

Base register number. 

Address counter number. 

The relative memory location (in 
octal) of the data or instruction 
(13 bits), or the operand of the 
instruction. 

The first half of the data or 
instruction containing the operation 
(upper 16 bits left-adjusted). 

Flag for external reference (R) or 
transient reference (T). 

The label associated with the source 
statement or the first 10 characters 
of the input statement. 

A character field containing the 
remainder of the CMS-2 source state- 
ment. 

Four characters of the card ID that 
appeared on the card associated with 
the statement (columns 1 through 4). 
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SID 



CR 



Four characters of the card ID 
representing the statement number 
(columns 5 through 8). 

The remaining two characters of the 
card ID. May contain a flag (R) 
in column 9 if the source statement 
references a reserved word (see 
Appendix D) . 



10.3 LOCAL CROSS-REFERENCE LISTINGS 

The local cross-reference (CRL or CR) listing provides a record of each symbol de- 
fined in the system element; the listing shows the location of each symbol and all re- 
ferences to that symbol. Also included in the list are global symbols defined in other 
elements but referenced within the current element. If no CR or CRL is requested, 
only unallocated identifiers and references are listed. The listing contains a page 
header at the top of each page. The header shows the name of the system procedure, 
the date of the run, and page number. The body of the listing consists of several 
columns, as follows: 



Column Heading 
AC 

S 

LOC 



LABEL 



Meaning 

Address counter number. 

Base register number. 

Gives the relative location, in octal, 
of the following label. A location 
of all sevens denotes an allocation 
error. 

The label to which the references 
apply. The labels are printed 
alphabetically. The symbol "******•#» 
denotes a generation error in refer- 
encing an identifier. 
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EXT This column identifies the label as 

being defined as local or external to 
the system procedure (blank means 
local to the system procedure, D 
means external definition, M means 
local, implicitly MODE defined in 
the system procedure, R means 
external reference, T means 
transient reference). If not blank, 
the label will also appear in the 
global cross-reference listing. 

REFERENCES A set of octal addresses within the system 

procedure that shows the location of each 
instruction using the preceding label. The 
word NONE appears if there were no 
references to the label. The references are 
given in the same format (AC S LOC) as the 
location of the referenced identifier. 

10. 4 GLOBAL CROSS-REFERENCE LISTING 

The global cross-reference (CRG or CR) listing provides a record of each global ele- 
ment defined in the system, showing the name of each system element that referenced 
it. The global cross-reference appears at the end of the compile. 

The listing consists of a header at the top of each page; the header contains the name 
of the system, the date of the run and the page number. 

The body of the listing consists of several columns, as follows: 
Column Heading Meaning 
EXT The label is an external reference. 

The definition is presumed to be 
given in another compile-time system. 
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LABEL 



The label of the element referenced. 



Labels are printed alphabetically. 



DEFINED IN 



The name of the system data design 
or system procedure that contained 
the element . 



REFERENCED BY 



The name of each system procedure 
that referenced the label. 



10.5 SYMBOL ANALYSIS FORMAT 

The symbol analysis (SA) option provides information as to the usage of the 
symbols in the system compilation. The analysis utilizes the following cate- 
gories (the items in the individual categories are printed in alphabetical 
order): 



a. Files. 

b. Formats. 

c. Tables (including subtables, like-tables, item-areas, fields). 

d. Switches. 

e. Variables. 

f. Procedures -functions. 

g. Index registers declared locally. 



A header, printed at the top of each page, gives the heading SYMBOL ANALYSIS 
and the identifier as either a SYS-DD or SYS -P ROC name. Each of the above 
categories is headed by the category type and bracketed with lines of asterisks. 
The following are descriptions of the headings for the various categories: 

a. Files : 

The general heading is FILES DECLARED. The columns are: 



Column Heading 



Meaning 



NAME 



The name of the files. 
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ML) 



TP 



HRDWR 
MXSZ 
MXRCL) 
NSTC 



The file mode: 

U - Hollerith. 
B - Binary. 

The record type: 

V - Variable length. 
F - Fixed length. 
S - Stream. 

The hardware code. 

The maximum record size. 

The maximum number of records. 

The number of associated status 
cons tants . 



Formats : 

The general heading is FORMAT STATEMENTS. There are eight identical 
heading sets of two headings each as described below: 



Column Heading 
N AMI- 
XT 



Meaning 

The name of the format. 

If declared, the external identifh 
R, for external reference or I) for 
external definition. 



Table s : . . ■ ' 

The first segment of the print line identifies the table or assoei.tl. 
table. The second segment identifies the attributes of the table or 
associated table.- The third segment identifies the fields and their, 
associated attributes. 
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Column Heading 
TABLE-NAME 



ASSOC 
NAME 



ASSOC 
TYPE 



TP 



NI 
TM 



PACK 
NDIM 



ADD 
MOD 



Meaning 

The name of the prime table being 
described . 

The name of a subtable, like-table 
of item-area associated with the 
prime table . 

One of the following: 

SUB - Subtable. 
LIKE - Like-table. 
ITEM - Item-area. 

Denotes the type of the prime table: 

H - Horizontal . 
V - Vertical. 
A - Array. 

If the length of the table is 
variable (specified by a NITEMS 
statement), this column will con- 
tain NT. 

Denotes the packing usage on fields 
for horizontal or vertical tables 
or denotes the number of dimensions 
if an array; this may be NULL, 
MEDIUM or DENSE or an integer from 
1 to 7. 

Indicates whether the table is 
addressed directly (DIR) or addressed 
indirectly (IND) . 
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WDS/ 
ITEM 

INDEX-NAME 



NO. ITEMS 
DIMS. SIZE 



EXT 



START 
ITEM 

FIELDS 

NAME 
TP 



SN 



START 
BIT 



Specifies the number of words per 
i tern. 

Gives the name of the major index 
for the table or the associated 
table . 

The number of items if H (horizontal) 
or V (vertical) f or the size of the 
dimensions if A (array) . 

Designates whether the table or 
associated table is externally 
defined (D) , externally referenced 
(R) , or transiently referenced (T) . 

The item number at which the 
associated table starts. 

Applies to the remainder of the 
headings. 

The name of the field. 

Defines the field type: 

F - Floating-point. 
B - Boolean. 

H - Hollerith characters. 
A - Arithmetic fixed-point. 
I - Integer. 

Indicates whether the field type 
is S for signed, U for unsigned, 
or blank if neither S nor U apply. 

Starting bit position in the word. 
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WORD 
LOC. 

NO. BITS 
OR CHARS 



KB 



The word number by which the field 
is addressed. 

Designates the number of words for 
multi-word fields, the number of 
bits for types F , A, or I , the 
number of characters for type H , 
or the number of status constants 
for type S . 

Fractional bi ts . 



d . Swi tches : 

The general heading is SWITCHES 
Column Heading 
NAME 
TYPE 



NO. PTS 
EX 



SHSW-CVRBL 



The columns are: 

Meaning 

The name of the switch. 

One of the following: 

S - Statement switch. 
P - Procedure switch. 
IT - Item switch. 

Gives the number of switch points. 

Defines the external specifications 

R - Externally referenced. 
T - Transiently referenced. 
D - Externally defined. 

Indicates the name of a shared 
switch; if the switch is an item 
switch (IT), the compared variable 
is given. 
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INPUT 

PARAMETERS 

OUTPUT 
PARAMETERS 



Three columns of input parameters 
if switch type P. 

Three columns of output parameters 
if switch type P. 



Variables : 



The general heading is VARIABLES. The columns are: 



Column Heading 

NAME 

TYPE 



EX 



SN 



FB 



NO. CHAR. 
BIT 



Meaning 

The name of the variable. 

Gives the variable type: 

F - Floating-point. 
B - Boolean. 
S - Status . 
I - Integer. 

A - Arithmetic fixed-point. 
H - Hollerith. 

Defines the external specifications, 
if any: 

D - Externally defined. 

R - Externally referenced. 

T - Transiently referenced. 

M - Implicitly and locally defined. 

Specifies whether signed (S) or unsigned 

(U). 

Fractional bits. 

The number of characters, bits, or 
status constants depending on type. 



y 
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f. Procedures-Functions 



The general heading is PROCEDURES -FUNCTIONS. The columns are: 



Column Heading 

NAME 

TP 



INPUT 

PARAMETERS 

OUTPUT 
PARAMETERS 

EXIT 



Meaning 

The procedure or function name. 

Either P (for procedure) or F (for 
function) . 

Four columns listing the input 
parameters . 

Four columns listing the output 
parameters. 

The names of any abnormal exits. 



Index Registers Declared Locally : 

The general heading is LOC-INDEXES DECLARED. The columns are: 



Column Heading 
NAME 

REG 



PROCEDURE 



Meaning * 

The name of the local index declared 
for the current system procedure. 

The B-register assigned to the 
above symbolic name, or the letter 
T if a temporary cell is assigned. 

The name of the procedure in which 
the local index is defined. 



10.6 COMPILER ERROR SUMMARY 

At the end of each compile-time system for which the OBJECT option is used, a 
summary of errors is listed. The name of each element, its element number 
within the compile and the number of syntax/generation errors and the number 
of allocation errors are listed. The syntax/generation errors are individually 
listed at the front of the compile listing. The allocation errors are flagged 
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in the source (and mnemonic) listing where t hey occurred and are ahso list « tj 
in the local cross-reference. 
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SECTION 11 
ASSEMBLER 

11.1 ASSEMBLER FUNCTIONS 

The Assembler accepts symbolic source code in 80-column card image format 
and translates this coding into an object machine language suitable for 
loading into the AN/UYK-7 Computer memory via an object-code loader program 
(see Section 3 of Volume I). The Assembler operates in conjunction with the 
Monitor to provide programmers with a level of programming assistance not 
ordinarily associated with an Assembler class of language processors. 

The Assembler capabilities include: 

a. Macro directives as well as other directives which enable the 
programmer to control the assembly process in a positive way via 
conditional assembly. 

b. A powerful set of directives which enables variable bit-field 
definitions, character substitution, segmentation, and so forth. 

c. The ability to handle multiple addressing sections (counters) for use 
in segmenting and assembly-time allocation control. 

d. Printer side-by-side listings of the symbolic source code and also an 
edited representation of the generated object code. 

e. Optionally selected printer listing of all alphanumeric labels 
referenced within the source code. The labels are separated into 
internally referenced labels and those which can be referenced from 
another program. 

f. Optionally selected printer listing of all alphanumeric labels cross- 
referenced with their respective addresses. 

g. Evaluation of arithmetic and logical expressions. 

h. Relocatable object machine code output which employs full binary card 
image format (960 punches per 80-column card). 
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i. All Assembler-detected errors in source statements are flagged when 
encountered. 

The $ ASM card commands the Monitor to place the Assembler In memory and 
initiate its execution. 

In operation, the Assembler scans the subsequent symbolic input code twice. 
The first assembly pass performs a pseudo-generation primarily to record any 
programmer-defined nacro sample code and to define forward referencing. The 
second assembly pass simultaneously produces the object code and the program 

listing. When referenced in the program, generation for macro sample code is 
carried on as a subassembly of the main program. Figures 11-1 and 11-2 show 
the basic functions performed during the first and second passes, respectively. 

11.1.1 Input Language Structure 

Inputs to the Assembler consist of programmers prepared symbolic coding 
statements. The programmer has one basic unit available when constructing 
symbolic code on the coding sheet. This unit is the operation which may 
consist of three parts: 

1. Label. 

2. Statement. 

3. Notes. 

The label and notes are generally optional attachments to the statement and are 
always separated from the statement by at least one space. In order to apply 
notes, the statement must be terminated by a period (. ) . 

Format 

ILAfeEL , , STlATiEMfMT* i ■ I ,NAT,gS, ,. , , I 

A program written in the CMS -2 Macro Assembler Mnemonic Language consists of 
action statements. Their structure is discussed in the following paragraphs. 

11.1.1.1 Label 

Within the programming language, the labels consist of 1 to 8 alphanumeric 
characters. The first character of any label must be a letter. The letter 
should also be used with caution as any character of a label because of the 
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Figure 11-1. Assembler Pass 1 Data Flow 
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visual difficulty in distinguishing it from zero. A label is used to identify 
a statement which may be referenced by another. 

11.1.1.2 Statements 

Except for purely comment statements, programmers are normally concerned with 
three basic fields of a coding line: 1) label field; 2) operation field; 
and 3) operand field(s). A line of coding is defined as a logical symbolic 
statement not necessarily confined to a single physical line; for example, a 
logical line may extend over several cards. 

11.1.1.2.1 F ields . Fields are delimited by at least one space following the 
last character of the field. There can be no spaces between characters of an 
element or expression within a field or the Assembler will interpret the 
space as the end of the field. The label field is always assumed to start 
in column 1; if there is no label field, its absence is indicated by at least 
one space starting in column 1. 

11.1.1.2.2. Subf ields . Any field may consist of one or more subfields 
separated by a comma and terminated by a space. There can be no spaces between 
the characters of a subfield or between the subfield and its terminating comma. 
The Assembler interprets the first space as terminating the current field. 
To the Assembler, a comma indicates that another subfield follows; therefore 
the last subfield coded does not terminate with a comma f since a space 
terminates both the field and the last subfield. Any number of spaces may 
intervene between a terminating comma and the first character of the next 
subfield, since the Assembler was alerted that another subfield will follow. 

11.1.1.2.3 Omission of Subfields . The first subfield must always.be expressed 
If the programmer desires to omit this field, he codes a zero followed by a 
comma. (A coded zero is not legitimate as the first subfield of the label 
field). 
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Intermediate subfields may be omitted by coding two successive commas, or comma- 
s pace -comma , or comma-zero-comma . The Assembler interprets any of these 
representations as assigning a zero value to the subfield. Trailing subf ields 
may be omitted by following the last expressed subfield with at least one 
space. The Assembler assigns a zero value to any missing subf ields. 

U.l.1.2.4 Statement Continuation . A logical coding line may be interrupted 

at any point (except between apostrophes) by coding a semicolon (;) as the 
next character and continuing the line on the next physical line; i.e., next 
card. The Assembler ignores any characters following the semicolon on the 
interrupted line and continues its scan starting with column 1 of the next card. 
The sequence of coding on continuation statements must follow the syntax 
rules governing fields and sub-fields. 

11.1.1.2.5 Statement Terminat ion and Notes . Programmers may include notes as 
part of their coding lines by following the statements with a period followed 
by at least one space. The period space combination, except when it appears 
between apostrophes, causes the Assembler to stop scanning for additional 
fields or subfields. If a coding line involves a fixed number of fields 

and subfields and all are encoded on the line, programmers may add notes without 
the preceding period space combination, since the Assembler ceases scanning 
when the last required field or subfield is evaluated. A coding line may be 
nothing but a notes line. In this case, the period space must precede the 
first character of the notes. Any number of spaces or no spaces may precede 
the period. 

11. 1.1.2. 6 Blank Card Images. Blank cards (source statements containing no 
non-space characters) are given a source line number but are otherwise ignored 
by the Assembler. It is important not to include blank cards within macros 
since this results in slowing up the expansion of them, whenever called. 

11.1.1.2.7 Lan guage Structure Summary . Spaces delimit fields. A comma 
delimits a subfield except for the last encoded subfield which terminates 
with a space. A semicolon (except when it appears between apostrophes) 
denotes line continuation, causing the Assembler to continue its scanning with 
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the first character of the continuation line. A period space combination 
(except when it appears between apostrophes) signals the Assembler to terminate 
line evaluation. 

11.1.1.3 Notations Used In This Section 

Whenever a statement or operation is described in this section, a uniform 
system of notation is used to define the structure. This notation is not part 
of the language, but is a standardized notation that may be used to describe 
the syntax (construction) of any programming language, thus providing a brief 
but precise means of explaining the general patterns that the language permits. 
It does not describe the meaning of the statements or operations but merely 
describes the structure; that is, it indicates the order in which operands 
must appear, the punctuation required and the options allowed. 

11.1.1.4 Coding Gontrol Statements 

Control statements direct system performance rather than user program gener- 
ation. Comments, printer page control and product directives are in t h is 
category. 

11. 1.1.4.1 Comments, . A comment is a special type of operation which may appear 
anywhere within a source program. The usage of a comment is optional. A 
comment in the source program does not produce any generation and is detected 
by the system under the same form as notes in a language statement; that is, 
following a period and at least one space. 

Fo rma t 

I i i i i • I i i i iClOiMMEiMiTiSi i i I i i i i i i i » i 1 , . , . , . 

11.1.1.4.2 Printer Page Control . If the first character of a language statement 
is a slash (/), the printer listing will be ejected to the top of the next page. 
The character may precede a label, a statement (in absence of a label) or singly 
on a separate card image. 
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Fo rmat 

I/iLABEiLi 1 iVi'i i i i i i 1 i i i i i i Mil I . i . i i 

1A i • i i H&fTiEiSi i i i i i i I i i i i i i i i i I i . , i . i 

1/ i i i i i 1 ii i i i i i ii I i i i i i i i i I I i i I ii i 

11.1.1.5 Directives 

There are two forms of directives: 1) those that direct the system and prod- 
ucts to perform specific functions, and 2) those that direct the Assembler 
generation. Within the Assembler generation, the directive is a predetermined 
mnemonic coded in the operation field of a language statement. 

These directives take the same form as the language structure of paragraph 11. 1. 1. 

Fo rma t 
CODE: -'DIRECTIVE 

^D I.R.E.CfTil.va . ■ i . i ■ ■ ■ ■ Ui « HiOTiESi ■ 1 i i i i i i i 

11.1.2 Addressing Sections 

The Assembler provides the programmer with the ability to assemble program 
sections which are intended to operate as a single program unit, but which, for 
segmenting purposes, the programmer may consider discrete. A simple example 
is the case of any program unit consisting of instructions and data. One good 
purpose for keeping them separate is to take advantage of hardware overlap in 
accessing data from within instructions (see Section 3, Volume I of this 
document). 

11.1.3 Segmentation 

Segmentation is accomplished through use of the SEGEND and PXL directives. 
SEGEND is used when assembling back-to-back segments. PXL is used to output 
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externally defined labels to be used as source input in programs assembled at 
some other time. 

11.1.4 Assembly Base Addresses 

The Assembler initially sets all initial address counters to zero. The base 
address of any address counter can be set to some other value by beginning 
coding for that counter with a SET ADR directive. When generating code for the 
AN/UYK-7 this may have the effect of biasing the base register number on all 
references to words associated with that address counter. In generating code 
for non-base register machines, address counter values may have a direct 
correlation to physical memory addresses. 

11.1.5 Conditional Assembly 

Sometimes it is desirable to code a program on a modular basis. Certain 
sections of the program may not be needed at any given time. Whether to omit 
or include this code may be based on a condition known at assembly time. 
This leads to what is sometimes called conditional assembly which can be made 
by two methods: 

a. Any given source statement can be generated dependent on the 
setting of a condition known at assembly time. This can be done 
by coding the statement as part of a DO line, where the DO count 
is Hie result of the condition (either or 1). 

b. An instruction or series of instructions can be effectively over- 
ridden or included in object output by following these instructions 
with a negative reserve (RES) directive, dependent on the result of the 
condition. If the result of the condition is one, the specified number 
of previously generated lines of code are overlain by those following 
the negative reserve line. 
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Format 



. i i i i i i i i IOiO iBAiNiKiSi>i2I iL.BiJi »Bi7UIPiAiXi .#i i i . i 1 




iWi iLiftJi IdiT^iPiAiXi l6ie.M l e,RAT l E,D, |X,F r i i i i i i i 1 


•1 


PA|N|K,5| fljA|Si iAM iAiS|SieWftL|Y,.,T,liM|£, ,V|A,U,tl,6l I I M I 1 


•i 


»6,R.E,A,T,E,R, IT.H.A1N, i2,?i O.TIH.E.R.VM S.E. .N.OI iWORiD. , 1, , 


♦ i 


iXiSi i(5£iN£iRlAiT£iQ. 1 11 1 1 1 1 1 1 1 11 11 1 1 1 11 1 1 1 11 1 


■II i i I i i i i 1 i i i i i i i 1 i iii i i i i i i 1 i i i i i i i i i 1 


*IUIUHRlAURl( !E EIFI)ISI ,ISI mEJSTlPiRlOlGM.il 1 1 1 i t 1 I I 1 1 1 


BiAiWKiSi i ii i £iQUi i2i i i I i i i i i i i i i i i i i i i i i i > I 


1 1 1 1 1 1 1 1 1 fl 1 1 1 1 1 1 1 1 III illllll Mllllll 1 


PiAiXi mini LAi i i2| % iD|A|Tl XI ^i3i iiiiiii i i i i n i i i 


i i in i i i i I'i i i i i i i i i 1 i i I i i i i i i 1 i i i i i i i i i 1 


i i i i i , i i i R1E1S1 i(iBiAiWitCS<3i)i^(iPiAiXn#l)i mm m m 


»i 


lASiSiUiMtfNiGl 1M1O, iC,HAiNA4 ,0,F, AOARiEiSIS! 1 1 11 , i n 


•i 


.COQNiTiSR IM,UMiB£,R iDrfJiRIXiNAi Gf.ftEiRAIT.I.QN, , ,1 , , 1 


•i 


flF. iDAS 1AIBO1VA ,GO,DZiNlG,,, 1A1L1L1 Ofi ITiH.fi 11 1 1 11 


•i 


ilMiSiTAUiCiTlZAMiSi iB£i6iXiNlNiiiHGi lA.T .PlAlX, 1, .1 11 11 


*i 


1AM1D ififl^XlMiGi WIiT.H. .T1HI6 .CW1R1R1E1M.T1 1 , 11 11 11 11 


•i 


,A.D.0R£.S6. COUMiTfiR, ,\MILU,E, mi, iMOLlLi »BiEi 1 1 1 ,. 


♦i 


rfW.er.R.LA.T.All ,B,V, .THAT, i6feMi6.RA.T£iD , 1 ...... . , 1 


•i 


eOLLflMIHfa T.H.E, .RES \LXME*. . . 1 . 11 n. 



11.1.6 Library Usage 

Source library programs can be included within the calling program at the po,int 
at which they are called. 

11.1.7 iMacros 

Often programs require repetition of sequences of coding not necessarily 
identical but similar enough so that repetition of the coding becomes mechanical. 
A device within the Assembler which generates such sequences is called a macro. 
The Assembler stores the a< ro sample code when encountered and generates this 
coding whenever the procedure is called upon. The Assembler modifies the lines 
generated in accordance with parameters supplied in the calling line Are fere nee 
Jine. 
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11.1.0 Expressions 

An expression is an elementary item or series of elements connected by operators: 
which, when evaluated, results in a binary value, a floating point number or 
a memory reference address. If more than one element is included within an 
expression, they must be separated from one another by operators. An 
elementary item is an expression containing only one element. 

11.1.9 Assembler Generation 

The Assembler generates object code in accordance with the capabilities of the 
AN/liYK-7 Computer instructions. 

11.1.9.1 Full-Word 

Full words are generated from computer instructions, data words, FORM reference 
lines (see paragraph 11.3.3.8), and character strings. One data word can pro- 
duce up to two computer words of object code. A character string can generate 
a variable number of computer words. 

« 

11.1.9.2 Half-Word 

If a number of successive half-word (16-bit) instructions are encountered by 
the Assembler, they are packed two per word. When a half-word is encountered 
between two full words or is the last of an odd number of successive half- 
words, it is generated in the upper half-word and the lower half-word contains 
zeros. 

1 1 . 1 . 10 Temporary Storage 

Two modes of temporary storage are available: 1) magnetic tape, or 2) com- 
puter memory. The standard mode is storage on magnetic tape. Small programs 
can be assembled using core memory as temporary storage (see paragraph 11.2.1). 



11-11-11 



M-5035 
Change 1 

11. 1.11 Assembler Output 

Output from the Assembler consists of relocatable object code. This output 
is in a format recognized by the Object Code Loader and may also be composed 
of Loader directives passed on through the Assembler source input language. 

11.1.12 Assembly Time Allocation 

Allocation of address sections can be achieved at assembly time by including 
Object Code Loader directives in the source input to the Assembler (see Section 
3, Volume I of this document). 

11.1.13 Linking 

Values corresponding to labels can be made available to some independently 
processed code by suffixing the labels with an asterisk. Conversely, symbolic 
program names not defined within the current program can be referred to, and the 
necessary information is saved to provide a link to the program which defines 
them. The current program simply declares these names in the operand field 
of a LINK directive. 

11.2 CONTROL CARD 

Generally a card containing an asterisk (*) in column 1 is considered by 
the Assembler to be a control card. One exception to this rule is when 
column 2 contains a space (blank). This combination is used to achieve assign- 
ment of a particular line of coding within a macro to a label found on the 
macro reference line (refer to paragraph 11.4). Those non-Assembler control 
cards found between the first card and assembly terminating END card are 
transmitted to the output code when they are encountered. 

11.2.1 Start Assembly (ULTRA) 

Each program submitted for assembly must begin with the ULTRA statement. 
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Format 

*ULTRA, source-option, object-option, listing-option name, version 
Explanation 

Source Option One of the following (option: R may be used with M/S): 

M - Memory will be used as the intermediate device. 
S - An ISCM tape will be built which contains the source. 
It will be used as the intermediate device. 
Blank - A scratch tape will be used for the intermediate 
device. This is the default option for source. 
R - Source will be resequenced. 

Object Option Any logical combination of the following: 

D - Disable object output. 

S - An ISCM tape will be built which contains the object 
output of the assembly (s). This output will be 
saved for the user. 

P - Object output will be in the form of binary 
punched-card decks. 

E - An ISCM tape will be built which contains the object 
output of the assembly(s). This option should be 
used when the user wants to assemble, load, and 
execute his program but does not want the object 
output saved after his job has been run. This is 

1 the default option for object and is necessary only 
if this option is desired in addition to one of the 
other object options. 
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Listing Option 



Any combination of the following: 



Name 



S - An ISCM tape will be built which contains the side- 
by-side listing output. 

H - The side-by-side listing will be output to the printer. 
This is the default for listing and is necessary only 
if this option is desired in addition to the above listing 
option. 

A one to eight-character name which will be used to build 
the object output program ID and the library element 
IDs for ISCM tape output(s). 



Version 



A one to four -character version which will be used to 
build the object output program ID and the library element 
IDs for ISCM tape output (s). 

For options which request output on an ISCM tape, the ISCM tape will be given the 
following internal and external names : 



Field 

Source Option 
Object Option 

Listing Option 



Option 

S 
S 
E 
S 



Internal and External Name 

ASOURCE 
AOBJECT 
ACOMMON 
ALIST 



No spaces are allowed on the label field between *ULTRA and the three following 
subfields nor can any be present between the program name and version. 

The resequencing option causes the last twelve columns (69-80) to be overlaid with a 
period-space, four character name, four character number (starting at 0001), and two 
spaces. The four character name is taken from the first four characters of the element 
name specified on the "ULTRA card. The final two spaces allow for insert numbers 
when the assembler is not resequencing. 
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Examples 

1*IIJIIJT)R]AIJS1R1,IS1 ITIEISlTlPlRIOlGl I.I I I 1 I I 1 I I I I I I I I I I I I 

The ISCM ASOURCE and AOBJECT tapes will be built, the element will be named 
TESTPROG, and the source will be resequenced on the ASOURCE tape with 
. TESTxxxxA A(A = space, x = number) in columns 69-80 

The programmer has the added option of specifying what is to be overlaid in 
columns 69-74. By immediately following the R with a left parenthesis, any 
combination of six or less characters, and a right parenthesis, the characters 
(as many as specified) in columns 69-74 would be overlayed with the information 
between the parenthesis. 

Example 

|*|U i LjT|RjA| ,|R) ( |R|E|E|F| )| S\ , [S\ jT.EjS fT l P l R|Q|q I • I I I l I I I I I I I I I 

The ISCM ASOURCE and AOBJECT tapes will be built, the element will be named 
TESTPROG, and the source will be resequenced on the ASOURCE tape with 

REEFxxxxAA 

in columns 71-80 

Assemblies may be stacked back-to-back for Assembler input. The Assembler detects 
the end of a given assembly through the occurrence of an END or SEGEND directive. 

The parameters following the * ULTRA are evaluated for the first *ULTRA card only 
and are then effective until the stop assembly card (*OFF) is encountered. The name 
and version on the first * ULTRA card of each source program is used as the name 
and version for that source program. 

Assemblies requesting source, object, or listing output should always include a 
name on the *ULTRA card to allow element identification. If no name or version 
is supplied, spaces will be used. 
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11.2.2 Stop Assembly (OFF) 

The last program to be assembled (or only program if there is but one) ter- 
minates with the following card: 

l*lOlFlFl»l I iN l Q iTfe lSl I I I I 1 1 1 1 I I I I 1 I I I I I I I i l l I I II I i 

"OFF appears in the label field and all other fields are empty. 

11.2.3 Disable Object Output Code (0F0) 

If no object output is wanted for one or more of a number of stacked assemblies, 
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a programmer codes within the source deck(s) the following statement: 



ho i F i Qi I ' l i i NipIT iEiSi 



i i i i i i i i i 



1 II I I M il 



*OFO appears in the label field and all other fields are empty. 

If no object output is wanted for all the stacked assemblies, a 'D' is coded 
in the object options subfield of the first *ULTRA card, thus eliminating the 
need for *0F0 cards in each source deck. 

11.2.4 Sample Deck Using Control Cards 

figure 11-3 and 11-4 show sample source decks to illustrate the use of Assembler 
and Monitor control cards. 



11.3 SOURCE STATEMENTS 

A source statement is a coding line not necessarily confined to a single 
physical line; for example, a logical line may extend over several cards. 
Except for purely comment lines, programmers are normally concerned with three 
basic fields of a coding line: 1) label field, 2) operation field, and 
3) operand field(s). 

11.3. 1 Label Field 

The label field must start in column 1 of the source line. The label field 
of a line of symbolic coding may contain: 

a. An address counter declaration. 

b. A symbolic label. 




Figure 11-3. Sample Deck Using Control Cards 
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c. An address counter declaration followed by a symbolic label. 

d . An asterisk (*) in place of a symbolic label. 

If an address counter declaration and a label appear in the label field, the 
address counter declaration is coded first followed by a comma (,); then the 
label is coded as in line 2 of the example shown on the next page. 

The label field may be preceded by the control character slash (/), which 
causes the Assembler printer listing to be ejected to the top of the next page. 
If the slash control character is us*-d, it must be coded in columnl, and the 
label field must then start in column 2. A space in column 1 (or in column 2 
if column 1 contains a slash) implies that the label field is empty. 

Examples 



*<f4|)i i i i i 


,DlOi 4 ,Q 1 , 


i i*i 


,G^UN,T|B,R, ,D,e£t,A,R l AlT,I,ON, , 






i i'i 


■COURTIER, ,&E£.l, LAB£L 


I i i i i i i i 


iSIBi i6|)|CiAiTi,i3i i 


i i'i 


iUiNiLiAiaeiLieiOi itjCixiQ i m ,,, 


K r |L|EiSi i i i 


ifkau, ,uiw, ill i 


i i*i 


iL^i3fiL| |0,M,L|Yi Mill 


A*m 1 1 1 1 


|S|& i6diCiAiT|-»i9i,3i 


i r\ 


iPiA6£i I£iJ,BCiT, 4 1 iLiAIB£,L, , , 



11.3.1.1 Labels 



A label is a means of identifying a symbolic coding line. Normally a label is 
given the current value of the active address counter. Labels associated with 
EQU, FORM, GO, DO, MACRO, NAME and LIT have unique interpretations which are 
explained for these directives under paragraphs 11.3.3 and 11.4. 

A label may consist of up to eight alphanumeric characters. The first character 
must be alphabetic (A through Z) . Subsequent characters may be any combination 
of alphabetic or numeric characters (0 through 9) or $. 

An asterisk (*) may follow a label without intervening spaces. Asterisks so 
used do not count as a character of the label. If a label outside of a macro 
is suffixed with an asterisk, the label is externalized (defined as level 0). 
This label then becomes available outside the program. Refer to paragraph 
U. 4. 1.2 for an' explanation of the significance of starred labels within macros. 
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NEXT JOB 



1 JOB 




Transfer control 
to LABEL. 
Select obj'ect code 
by name (PR0G1). 
Library select the 
tape to load (ACOMMON) 
Call the Loader. 



Externalized label (LABEL). 



Call the Assembler. 



Figure 11-4. Sample Deck to Assemble, Load, and Execute a Single Program 
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11.3.1.2 Address Counter Declaration 

The first time an address counter is declared, it has the relative value of 
zero. Subsequent declarations of the same address counter cause the associated 
generation to continue at the next sequential address, regardless of how many 
other address counters were declared in between. A declared address counter 
controls the generated coding until another counter is declared. If no address 
counter is declared, the entire assembly is under control of address counter 
zero. 

Format 
$ (e) 

Explanation 

e The desired address counter 0=31. If an address counter 

is used in conjunction with the LIT' directive , the active 
address counter is not changed (see paragraph 11.3.3.14). 

11.3.1.3 Leading Asterisk (*) 

An asterisk (*) may be coded in the label field in place of a symbolic label, 
within macro definition coding. During macro expansion, this causes the label 
coded on the macro reference line to take on the value of the active address 
counter corresponding to the line containing the leading asterisk. The 
leading asterisk must be followed by a space, and can only be used within 
a macro definition. The asterisk must only appear once within a particular 
macro. 

11.3.1.4 Half -Word Instruction Labels 

The computer instruction repertoire includes a group of half-word (16-bit) 
instructions as well as full-word (32-bit) instructions. An Assembler- 
generated object word may, therefore, contain either a single 32-bit instruction 
or two 16-bit instructions. The programmer codes each half-word instruction as 
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a single source input statement. Two half-word instructions may not be coded 
as one source statement. 

The Assembler will collect two sequential half-word instructions into a single 
object word with the first occupying the most significant (upper) half and 
the second occupying the least significant (lower) half. A single unpaired 
half-word instruction will be placed in the upper half of the object word and 
the Assembler will pad the lower half with a no-operation instruction. 

Only those half-word instructions which will occupy the upper half of an object 
word (as described above for the Assembler's pairing convention) may be labeled 

Examples CODING 



AiSSiiMftE .A1D,D,R£66, £QUIM,T,6,R. .Q .IS, IACiTJMS MIT1H, 



iAi iCiUiRiRiEMITi .V.A.L.U.E, ,OFl ,0,00.01,0 ATI ,TH,Ei .TiliHEi 



j i 



000010 


1 





4 


3 








000014 




LA 


4 t G00F f W 


LINE 


1 


000011 


7 


1 


4 





5 







FLIP 


HOR 


4,5 


LINE 


2 


000012 


2 


4 


4 


3 








000014 




SA 


4,G00F f W 


LINE 


3 


000013 


7 


1 


4 


5 


3 







FLOP 


HAND 


4,3 


LINE 


4 


000013 


6 


2 


4 





1 







GOOF 


HLC 


4,8 


LINE 


5 



Line 1 is assemoied at relative address 000010. Line 2 is assembled into the 
upper half of relative address 000011; the lower half will be a no-operation. 
Line 3 is assembled at relative address 000012. Lines 4 and 5 are assembled 
at relative address 000013 and 000014 respectively, with the logical 
instruction in the upper half and a no-operation instruction in the lower 
half of each word. The label FLIP has a value of 000011; label FLOP has 
a value of 000013. Line 5 violates the half-word labeling convention; there- 
fore, references to GOOF have a value of 000014. 



11.3.2 Operation Field 

The first non-space (njrfn-blank) character following the label field is assumed 
to be the start of the operation field except when that character is a period 
or a semicolon. (A period space signifies line termination; a semicolon 
signified line continuation.) 
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the operation field may contain: 

a. A computer-instruction mnemonic function code. 

b. An Assembler directive. 

c. The label of a previously defined FORM directive. 

d. A label already defined as an entry point to macro coding. 

e. + or - followed by a data word. (When the operator is + or - , 
spaces may separate the sign from its related operand.) 

f. An apostrophe. (When an apostrophe is the first non-blank 
character following the label field, the remainder of the line 
through the terminating apostrophe is assumed to be a character 
string.) 

In any event, except as noted in items e) and f) above, a space following any 
character except a comma signifies the end of the operation field. 

Whenever a symbolic line results in generation of a computer word, the value 
of the controlling address counter is increased by one. An exception to this 
is the RES directive which causes the counter to be modified by the value 
derived from the expression in the operand field. 

11.3.2.1 Processor Instruction Mnemonics 

Processor instruction mnemonic codes consist of up to four alphabetic 
characters. All half-word instruction mnemonics begin with an H. 

11.3.2.2 Input/Output Controller Command Mnemonics 

Input/Output Controller (IOC) command mnemonic codes, like those for the 
processor instructions, consist of up to four letters. All IOC commands are 
32 bits in length. 

11.3.2.3 Directive Mnemonics 

The Assembler provides programmers with a level of programming versatility 
not ordinarily associated with an assembler-class language processor. This 
versatility is derived primarily from a group of symbolic assembler directives. 
Some of these directives allow the programmer to override the imbedded 
language of the Assembler, to redefine the size and field boundaries of 
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generated words, and to perform conditional generation; others provide for 

modification of the address counters and repetitive generation and still 

others permit character set substitution and equating one expression to another. 

A directive is a predetermined mnemonic written in the operation field of a 
coding line. Assembler directives fall roughly into two categories: 1) general, 
and 2) macro-oriented. 

11.3.3 Directives 

11.3.3.1 ABS Directive 

The ABS (ABSolute) directive is used to request a translation of an assembly- 
time address counter value into a run-time absolute address. 

Format 

| i i i i i i i i i lAi&S i i i i i i IC1A1T1 Miii i«l iFORiHiAiTi i i 

The above statement causes the sy value of CAT to be translated into its 
corresponding 18-bit run time address. The upper 14 bits of the generated 
word contain zeros. One practical use for such a directive is to create a 
value used to load a base register. 

.11.3.3.2 BYTE Directive 

The BYTE directive is defined for use solely to direct the Assembler's 
formatting of character codes in generated words. The BYTE directive enables 
the programmer to redefine the Assembler's imbedded character size and the 
number of characters packed in an object work. 

Format 

| i i &\Y\T£i i id ii'ie^r i i*i iFiOlftMAiT. ■ i i i i I . i i 

The BYTE line is written with BYTE in the operation field and one or two 
expressions in the operand field. 

Explanation 

6j The number of characters to be packed into the object 

word. 
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t\, ' The size of the character field in bits not to 

exceed a 16-bit character field. Expression e2 may 
be omitted if the character size is eight bits. 

The expression e^ * &2 must he s the number of bits in the object word. 

If the product of the two expressions exceeds that number of bits, the 
Assembler sets the expression error flag (E) , and ignores the line. 

Examples 



. i i iBYJ"|E| j i 


1 i2])|li6i i i 


i rl i^iXiAiMPit-iE| ill i i i i i i 


i ii I 


i i |B|Y|T|E| i i 


1 i^iyiGi i i i 


i !• iEiXiAiMiPiLiG i2l i i i i i i 


in! 



Assume a thirty-two-bit object word: 

The first example causes all character strings encountered thereafter (until 
the next BYTE directive) to be packed with up to two characters per word, with 
each character right-justified in a 16-bit field. 

The second example alters the generation to four eight-bit characters per word 
for all subsequent character strings. 

The BYTE directive must be used and expression e<> encoded if the CHAR (CHAK- 
acter) directive is used to define characters other than eight bits. 

The values of e^^ and e 2 must be determinable at the time the Assembler 
/ evaluates them. 

11.3,3.3 CHAR Directive 

The CHAR directive allows the programmer to redefine the Assembler's eight -bit 
imbedded character set used for generation of characters coded between apos- 
trophes (character strings). If the characters of the redefinition exceed 
eight bits, the programmer must have previously used the BYTE directive to 
define the maximum number of characters and the field size to be packed into 
an object word; otherwise, incorrect generation and/or truncation (T) errors 
occur. 

Format 
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The CHAR directive is coded with CHAR in the operation field and n pairs of 
expressions in the operand field. The first expression of each pair defines 
the octal code (000 through 377) which is to be redefined, and the second 
expression of each pair is the redefined value. In the absence of a pre- 
ceding BYTE directive, the Assembler assumes that the redefinition is an 
eight-bit character set. For all character string generation following a 
CHAR directive, the Assembler uses the redefined character codes until it 
encounters another CHAR directive which changes them. 

The use of a label on a CHAR line is optional. Values of expressions in the 
operand list must be determinable when they are evaluated. 

hl xamp.1 e s 



iCHiAjRi 




1 1 i 'iji5l i i i i i i i i i 1 i i 


• i i 1 Ai 1 1 


MM IPfiADMCfis, ,octa v ,«, 


R'i ,P,Rk>,D,U,C,6,S l ,00,7 ., , 


•l 1 iV»l 1 


,P«ADlU£,e,S, ,0,1 A., IAM.0, ,V 


,', (PRlODiJ.C&S, iGOS;, , 


, .'ARC. ,», .PiR.CD.U.Ce.S, lOcfTAL, 


,0A*O 1 ,6,0400s , , , , 


i*i A i 


flRAOACfi?, iQGTiAti 


06001000000,7, , , , 


i*i iR i 


■•. , ,.1 ,P,RO,0,U,C,E,S, lOiCTAli 


,001061,60,2465, , , , , 



11.3.3.4 DO Directive 

The DO directive causes a value or line of coding to be generated a stipulated 
number of times. DO is written in the operation field. The operand field 
contains two entries. The first operand entry is an expression defining the 
DO count (the number of times the second operand is to be done). The second 
operand entry is any valid symbolic line with or without a label. The two 
operand entries are separated by space comma. If there is no space following 
the delimiting comma, the line to be done is presumed to have a label. If one 
or more spaces follow the delimiting comma, the line to be done is presumed 
to have no label . 

Format 

LAiRCiLi i l DO le, 1,1 ,LH,U,B fflOi ,8,£, i>OM£, I , , , , iPOiftliAT, 1, , 
M6£iLi i AO, |«, i^UfliEiLi iLfffliEi iTiOi ,Rfc ID.O.ME, .FiQRhAT, , 
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There may be a label in the label field of a DO line. Such a label is not 
equated to the value of the address counter, but is treated as a unique counter 
ivitli initial value always one. For each iteration of the line to be done, 
the value of this counter increases by one until the DO count specified by the 
first operand expression is reached. 

To refer to the first word of a group of words generated by a DO statement, 
use a label which is not a part of the DO statement. 

Format 



X 


, i i i i , i IDiQ i2> .)! i+iQ 1 i i i i i i i i»i ILiIiMCi ill i i i 1 L.i....i_L_ 


It 


A.SrS^WIiHlG, |N|0| flftWi fl&F\MI\Tpm fPA\ 1X1 WIWH. 


1 • 


iWi iA|S,S|E,*i,b^y„, ,Xi iHIAiSi iA, ,FiWiL| iVAUlft 1V1 . , 


I* 


iI.Fi AMCi |MffiSiMEiOi im IR&F.EiR, .T1O1 iTWif. AAOAfiSSI , , , , 


I* 


.dau^TfiW .VA.LU.Ci £O.RIR6,S,POiWi0.r,Ni6l ,TA iTJHft .F.IIRS.T , 




WiDiRiD >6£IHiEiRiAiTiEiPi m W,Mi£i iHfc AOiDfi:, , 




i i i i i i i i i i i i i i t 1 i i i i i i i i i 1 i i i i i i i i i 1 ii i i 


i i i i t iii i DiOi 2i u i4A i i i i i i i i i i i i i i i i i i 1 i i . i 



Example 



IiTiERi j i i i i IDiQ i ifeSi rii HttiTiERi-ili i i i I i i i i i i i i i I , , , . 
i»i itWXiLiLj iftElSULT, J,M, ,651 S,UiC£i66iSg l V|giL,Vi ifiiEiMgiRAIT^EDi ■ 
■ •■ MO*iftS, 1HIA1VJM1& ,TH,E, IQCTAiLi VA.LAiie.S, .rABft , , I , ■ , , 
TMRCItm i i i r i i i i 011 Aft an iTHAITT OffftftRi ■ ■ I , , . , 

If the DO count exceeds 2 16 -1, an expression (E) error occurs. The Assembler 
arbitrarily sets the DO count to zero. 

The DO directive may be used to perform the line to be done on a conditional 
basis. In this context the first operand expression (the DO count) results 
in either zero (false) or one (true). When the result of the condition is 
zero, no action is taken. When the result of the condition is one, the line 
to be done is processed once. 
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Example 

'D>Q . .BAIMLSkA .%. ,R£,S iClATi-J, i 



J_L 



£AU,/kli .TOl 4. t , RESl£,R,V,6 .W.IiLiL, iQCCUft 



I I 



,TW£, PJ.ftRlE.Nrr, ,A,D,DJ?,£SlS ■CflU.MT.ER IWI.LL, ,&E 



irO.DJ.BIgd AY, .TH.S ,V,AlUJ,E, flF, &ATI-J 



h i I i i i 



DO directives may be nested. When nested, the innermost DO cycles to completion 
first, then the next innermost DO, and so forth. 

Example 

P i iftOi A mDIIi i DOi i 3i i,l i+tPi+iDili n i 1 i i i i ■ n i i I , 



Skfiuil flgl&P>6)GT.I.VifiLiVl ..... . i I i , 1 



The expression defining a DO count must result in a value determinable at the 
time it is evaluated. The maximum number of DOs which may be nested at any 
one time is 16. 

Since the label of a DO line takes on the value of the DO count, it cannot 
be used as a reference to the DO line itself. The programmer may, however, 
immediately precede a DO statement with a line consisting of a label field 
only. Whenever the Assembler encounters a line consisting of a label field 
only, the label is equated to the current value of the active address counter, 
but the counter is not advanced since no generation occurs; hence a reference 
to such a label immediately preceding a DO line has the effect of referencing 
the first word generated from the DO statement. 

11.3.3.4A EMBED Directive 

The EMBED directive adds defined values for certain assembly tags called Embedded 
Mnemonics. The embedded mnemonics are turned on by placing the following 
directive prior to an embedded mnemonic reference. 
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Format 

1 I l I lElMlBElDl I III i I I i.l IFIOiRiMA iTi I i I I I I I I I I I I I I 1 

The following is a list of the embedded mnemonics and their associated values: 

AO-0, Al-1, A2-2, A3-3, A4-4, A5-5, A6-6, A7-7 

BO-0, Bl-1, B2-2, B3-3, B4-4, B5-5, B6-6, B7-7 

SO-0, Sl-1, S2-2, S3-3, S4-4, S5-5, S6-6, S7-7 

KO-0, Kl-1, K2-2, K3-3, K4-4, K5-5, K6-6, K7-7 

Ql-4, Q2-5, Q3-6, Q4-7 

L-l 

U-2 

W-3 

Hl-1 

H2-2 

Any given embedded mnemonic will be used only if the programmer has not defined 
that tag. 

NOTE 

An embedded mnemonic reference may not be used in 
assembler directive fields which affect the address 
counter, namely - RES, DO, SETADR. This type of 
usage may cause labels following those directives to 
be flagged as a D error. 

11.3. 3. 5 END Directive 

An END directive indicates the end of symbolic input to the Assembler or the end of 
a macro coding sequence. Each program to be assembled must have an END directive 
signifying the end of the symbolic program. An END directive is not labeled. 

Format 

1 i i £MDi i i i i ■ . i i I . » . i i ,«i iPjOIRKAiTi t i i i rl 
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11.3.3.6 EQU Directive 



The EQU (EQUate) directive causes a label in the label field to be equated to the 
single expression in the operand field for all subsequent references to that label. 
If the programmer wishes to assign a value to a label, he must define the label via 
the EQU directive prior to any references to the label. The expression in the operand 
field must result in a determinable value at the time it is evaluated. 

Example 





i i lEfiU i 


i ,ei , , , 


mmIi'! iFORiMiAiTi 1 


W i i i 


i i i£|QiU| i 


i iAABi+,f ,/,2l 1 


ZI,P, , i , 


i i iEIQiU, i 


i iZiAR i 


I i 1 l li II l 1 .1 l 1 1 1 1 1 l 1 1 


Ji i i i i i 


, , ,510.11, , 


i A+M 


l i i l l i I I l i i i l l i I i i 1 


A ii4 ii i 


i I ifilQH I 


i i 1QI16 


i i i i i i i I I i i i I i i i i i 


BS 


, , ,Ekau, , 


i i i5i i i 


i i i i i i 


RH , , 


i i lEftM i 


i i A i i 


i i i i i i l I i 1 i I i I i I i M 1 



Except when it appears in Macro coding, a label defined by EQU may not subsequently 
be redefined or a duplicate (D) error occurs. Within Macro coding sequences, labels 
may be redefined via EQU lines unless the definition affects an address counter. 
The expression on an EQU within a Macro will be evaluated twice by the assembler. 
Thus, the user should be careful in his use of EQUs whose operand expression 
involves the label of the EQU. 



Example 



A* 
B* 



C* 
B* 



MA C 
E Q U 
END 
A 

MA C 

EQU 

+ B 

END 

C 

C 

C 



R 




R 
B + 1 



GENERATES 
GENERATES 
GENERATES 



2 
4 
00 00000006 
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Labels defined by EQU are not considered relocatable memory references unless 
the value of the operand expression is a relocatable memory reference. 

11.3.3.7 EVEN, ODD Directives 

The EVEN directive forces the current address counter value to an even number, 
thus subsequent words start at that number. 

The ODD directive forces the current address counter value to an odd number, 
thus subsequent words start at that number. 
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For either directive, if the condition is met, the Assembler ignores the 
directive. If the condition is not met, the address counter value is increased 
by one. 

Format 



fiViENj i i I i i n iFiQRiHAITi i i i i i i i i 1 i i i i i i i i 



iQPiDi i i i 1 i i i*i iFPiBMAITi i i i i i i i i 1 i i i i i i i i 



11.3.3.8 FORM Directive 

The FORM (FORMat) directive describes a special word format designed by the 
user. This word format may include fields of variable length, the length in 
bits of each field being defined by the user through expressions in the operand 
field of a FORM line. The value of each expression specifies the number of 
bits desired in its respective field. 

Format 

iLAB&Li i if iOlRM i i^ijieijiJ'i^i'iMMvijUinNiAiMiOiTigSi i i I 

The number of bits specified by the sum of the values of the operand expressions 
must equal 32 or 64, depending on whether a single or double precision FORM 
word is desired. When a WRD (WoRD) directive is employed, the number of bits 
must be the word size, or twice the word size, but must not exceed 64 bits 
(see paragraph 11.3.3.21). The number of fields may not exceed 32. 

A format defined by this directive can be referred to by writing the label of 
the FORM directive in the operation field, followed by a series of expressions 
in the operand field which specify the value to be inserted in each field of 
the generated word or words. A reference to a specific FORM label always 
creates one or two words composed of fields in the same format. The content of 
the fields varies according to the expression values in the referencing line. 
Truncation occurs and an error flag is set if a given value exceeds the space 
permitted for a field as indicated in the associated FORM directive. The 
number of expressions in the operand field should equal the number of fields 
specified on the FORM directive. If fewer fields are coded, they are left- 
justified in the object word(s). Coded fields in excess of the required number 
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are ignored. 
Format 



I,N&T,g, iFlQRMI . ,3,, 3, y 3,, H,, , I ,fe 



i i i i i i 1 i i i i i i i i i 



j i ii i 



The line above would produce a word as follows: 26020410002 
Format 



I,N&T,f?,A ffi\KH , i6ir.>4i t . l.2L,l4 t> l fe,fe ,i^ 



i i i i i i i i i I i i 



i i i i i i 



The line above would produce the two words as follows, plus an error flag 
because the expression 167 (247 Q ) required more than six bits. 

26410000012 01750471204 

Expressions in the operand field of a FORM directive line must result in a 
determinable value. 

11.3.3.9 LCR Directive 

The LCR (List Cross Reference Table) directive instructs the Assembler to 
print symbolic names appearing within the program together with the program 
address (es) where the symbolic names have been referenced or used. This 
optional listing is produced following the normal side-by-side printed program 
listing. This directive can appear anywhere in the source coding after the 
*ULTRA header card. Only references to level or level 1 relocatable 
labels, to external labels, or to undefined labels will be saved in the cross 
reference table. Labels are alphanumerically sorted on the listing and 
appear as follows, (see also paragraph 11.9.4.5): 

LABEL ADDRESS COUNTER VALUE 

Format 

1 iLiCR i i i i 1*1 iFiQRiMiAiTi i i I i i i i i m i i 1 . i i i i V 
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11.3.3.10 LIBS Directive 

The LIBS (Library Select) directive permits the programmer to specify the names 
of the library tapes or the ISCM tapes that are needed for library retrieval. 
The LIBS directive statement works in conjunction with the LIB directive 
statement (see paragraph 11.3.3.11) with the following stipulations: 

a. A LIBS directive must precede any LIB directive(s) . 

b. A LIBS directive is effective until another LIBS directive is encoun- 
tered. The new LIBS directive then replaces the previous one. 

c. An element retrieved from a library should not contain a LIBS directive. 
If a retrieved element does contain a LIBS directive, that directive 

is flagged as an error and is ignored. 

Format 

LIBS internal -name (external -name ), internal -name (external -name). . . . 
Explanation 

Internal Name A one to eight-character name identifying 

the internal library tape label. 

External Name An optional external tape identifier. 

11.3.3. 11 LIB Directive 

The LIB (LIBrary element) directive permits the programmer to incorporate source 
library elements into his current assembly at the point where the LIB directive 
statement is encountered. The LIB directive must be preceded by the LIBS 
directive (see paragraph 11.3.3.10) 

Format 

I .L.IiBi iNiAiMiE/lV l eifti')i>iNi AiHiSn>fiEigi > > l »|.iM«i-l I I I I t I I I I I 

Explanation 

Name(Ver) Name and version of a library element to be merged. 

The version field is optional; but if it is ommitted, 
the' library element to be retrieved must not contain 
a version on the library tape. If a version is 
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specified but no name is specified, then all elements 
on the library(s) with that version will be retrieved. 
If neither a name nor a version is specified, then 
all source elements on the library(s) will be re- 
trieved . 

Library elements may be corrected during retrieval; and if an output ASOURCE 
tape has been requested for a tape containing Assembler source data (see 
paragraph 11.2.1), the corrected elements will be written on the ASOURCE tape. 
To correct a library element, a /CORRECT card must immediately follow the LIB 
directive (see Volume I, Section 4, paragraph 4.3.7). 

The retrieved library elements are assumed to be symbolic and are assembled as 
parts of the current assembly program. After the last requested element is 
retrieved from the library and assembled, the Assembler resumes processing the 
user's source program from the original input medium commencing with the symbolic 
statement immediately following the LIB directive statement. Use of library 
calls have the following limitations: 

a. Nested library calls are not allowed; that is, a called element may 
not ii self contain a call for another library element. 

b. A conditional library call may be used in conjunction with the DO 
directive to conditionally call a library element. 

Example 

I i iftQ iAi*ili i»l ) .i i iS^lMi|iJr j. i i j i i I i i i i i iii i 1 

This line would insert library elements SIN and COSIN into the user's 
source program if A was previously equated to an absolute value of 1. 
If A was not defined as being equal to 1, the LIB directive line is ■- 
ignored. Nesting of DO statements in conjunction with the LIB direc- 
tive is not allowed. 

c. If the called library element is a macro definition, it is the pro- 
grammer's responsibility to provide a subsequent call line and 
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parameters for the macro as part of his source program. 

d. If the called library element is a closed subroutine, it is the 
programmer's responsibility to establish parameters required by the 
subroutine and transfer control to the subroutine. 

e. A LIB directive used in conjunction with a DO directive is not 
allowed within a macro definition. 

f. If a macro is to be called from a library tape via the LIB 
directive, the total macro must have been entered into the 
library including its END line. 

g. A LIBS directive must precede any LIB directive(s). 

11.3.3.12 LINK Directive 

This manual has previously discussed external definition of a program label 
by suffixing the label with an asterisk (refer to paragraph 11 .3. 1 . 1) . By 
doing so, the programmer makes the value (usually a relative address counter 
value) available at load time to some other independently processed code. 

Conversely, the programmer may wish to refer in his coding to symbolic names 
of programs or data not included in his program. These symbolic names are 
called external references. The primary purpose for externalizing labels is 
to permit program and data linkages at object program load time. Both 
externally defined and externally referenced symbols are transmitted to the 
object program loader by the Assembler. 

The LINK directive is the means whereby the programmer declares externally 
referenced names. 

Format 

1 i 1U1U1K1 i i i INi^ iNi aiim'ijiMlfti mmmm It ifOiRiHAiTi i 1 

Explanation 

Nj through N n Symbolic names referenced by the source program but 

which appear nowhere as labels in the source program. 
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If the programmer references a symbolic name which is neither defined within 
his program nor identified by a LINK directive, the name is assumed to be 
undefined and is flagged with a (U) warning at each reference. 

NOTE 

If the LINKed name is referenced in the form "LINKed 

name-constant", the generated instruction (at load time) 
may not be what the user intended and a load time diag- 
nostic (MODIFICATION OVERFLOW - see paragraph 3.4.2.2 
Volume I) will be output. The programmer should link 
to the actual cell he wishes to reference. 

11.3.3.13 LIST, ELIST, and NOLIST Directives 

These directives permit programmers to control printed program listings . 
The Assembler always assumes that it produces a side-by-side source listing 
of the program being assembled. It assumes further that generated object code 
is printed with a space separating field within it. 

Example 



|i« M wp.|W|i| | | | M M | 

iLiISiT ii i i i i i i i 


1 1 1 1 • iriWIWM,! 1 Ml 1 1 | 

1 1 1 I 1 1 1 1 1 1 1 1 1 1 


! II II M 
1 Mil 1 1 


1 1 1 
1 1 1 


lEiHSTi iii iiiii 


Mil 1 1 1 1 1 1 1 1 1 


1 II Mil 


1 1 



Explanation 

NOLIST Causes the Assembler to suspend all printing of the program 
being assembled . 

LIST Causes the Assembler to resume printing after a NOLIST in the 
normal manner with object words packed. 

ELIST Causes the Assembler to print (or resume printing after a 

NOLIST with editing. This means that individual fields of the 
object word are printed with a space separating the fields. 
Literals are never edited. 
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The programmer may intersperse these directives in any combination throughout 
his program, but to obtain a complete listing, NOLIST lines should be removed. 

LIST and FUST lines are printed and NOLIST lines are not printed. 

If no change to the Assev.'. !.cr ' s printing assumptions is wanted, none of these 
directives need be used. 

11.3.3.14 LIT Directive 

The LIT (LITeral) directive activates a literal table under the control of 1 he 
currently active address counter. 

F o rma t 

llAftB Li i i ! iLII Ti i i i i i i i * I iFiQRiMiAiTi i i I i i i i i i i i ^. i 

The word LIT is written in the operation field. There is no operand field. 
The contents of the label field may contain an address counter declaration and 
or a label; however, the label, when present, may not be other than as described 
below, nor may it be suffixed with an asterisk. 

In the absence of a LIT directive, the Assembler enters all literals under the 
control of address counter zero. The LIT directive may be used to alter 1 his 
Assembler process. The Assembler eliminates duplicate literals within each 
address counter, but duplicates may exist within separate counters. 

If a LIT line has no label, the Assembler places literals not preceded by a 
label in the literal table designated by the LIT directive. Any number of un- 
labeled LIT lines may be used, each causing all subsequent unlabeled literals 
to be generated under the address counter related to this last LIT line, until 
another unlabeled LIT line is used. 

If the LIT line is labeled, all literals to be placed under its related address 
counter must be preceded by this LIT line label. 

The Assembler generates for literals during its second generative pass. It 
places all unlabeled literals under address counter zero until an unlabeled 
LIT directive overrides this process. 
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Examples 



1 ' » ' 1 i 1 1 1 1 1 1 1 lliUl II /III 1 1 1 I 


1 1 1 ! 1 1 1 1 1 1 1 I Mil 1 


•i iMi»JiOiU«X#M3l iNiU iriKiCA.iCilS4»Mftai 


ITT. 1 TlllC TUfi 


•l flPlTA*H .LflWAiL, ,,,, ,, , 


, iQ7it M ^ . , , 




iRQ i 1 i i i i i i i i i 


IiCiIiV i iiii LiXTi i i i i i i 1 i i t 


i i i i i i i t i i ii 1 ii 


i i i i i i i I 1 1 I 1 i i^A7,7i)i Iiii 


1 1 1 1 1 1 1 1 1 1 1 1 II 1 1 


•i iQC,TALi WBTi&RiA4h i i i i 1 i i i 


, ,Q7,7, tfH,L,L, |6A i ,il 


•V .ADIDRESS, .COUMlTCf?. 


iQMJEi i i 1 i i i i i i i i i 


iif ili) i*i2SAiPi i il-JiTT i i t i t i i i i i i i i i i i i i i i i i i 


i 1 1 i'i i i M i i i i i iZiAiPifonrMi 


i i i i i i i i i i i i i i i 


i i i i i i i i i 1 i i i i i( i0il|1|l|)i i i i ii i i i 1 i i ii miiiI 


•i iQCTiAiL ,LHT.6R^,L , < . i 1 , , , 


i i lOflil |W,X,L,Li iCG i i 


•i_jyyAM& AiDIDiRiEiSS. .COUNTER 


iQMEi i i 1%. AkD , i i , I 


•i A.SiSAJ«iIW.6l AliOi P,£e.V.IOIU«& ,UM.U.B£.Liej), .LiIT. ... 1 


-iLiXllifiu, . .OlCTiAiL iLITifeRIALi , 


. ,., , ■ . 1 0,11,7, MffiLLI 


&0i 4JJM)£Al AAOAE.S.& iCDUttXe,*, .ZfiRIO 1 



11.3.3.15 LLT Directive 

The LLT (List Label Table) directive instructs the assembler to print symbolic 
names appearing within the program together with their associated values. The 
listing is produced immediately following the normal side-by-side printed pro- 
gram listing. It does not include MACRO, NAME, FORM, and LIT line labels or 
labels which are purely local to a macro. 

Example 



I , i iImLiTi i i i I i i i t i t i i*i IfiOiRiHAiTT I i I I I i I i I I I I I 1 

Labels are alphanumerically sorted on the listing. v 
Format 

llABfiL, i ■ ml , i ■V.A.Lii.f. i l lAiDiDiRfiSiSi CMiMXtt,. : 
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Explanation 

N One of the following: 

D (duplicate) 
X (external reference) 
Blank 

The address counter is only printed when the label has a relocatable value. 

11.3.3.16 PXL Directive 

The PXL (Punch External Labels) directive instructs the Assembler to output 
all assembly level program labels which have been suffixed by an asterisk; 
that is, externally defined symbols. 

Format 

| . . ■ 1P1X1L1 nlimi MH iFIOiRiMAiTi i i i i 1 i I i I 

The labels are output as symbolic EQU statements which may then be used with 
subsequent assemblies at some later date. Each EQU statement has the format: 

Label EQU value, mode of value (e.g., relocatable, fixed point ) 

The PXL directive takes effect after the completion of assembly. The standard 
PXL output device is the card punch. 

11.3.3.17 RES Directive 

The RES (REServe) directive causes the value of the single expression in the 
operand field to be added to the currently active address counter. If a label 
appears in the label field of a RES line, it is equated to the current value of 
the address counter which is also the address of the first reserved word. 

Examples 



LAiBEili i 


i i iRKfiSi 


l i£i I l I 1 l i i l i i 


i i-i IFiQRMiAiT, nil 


*<i7<). i . 


, i iRlHfi 


, A+|4A9|fii iiiii 


i i i 1 i i i i i i ii i 


TiOiXi i i i 


i i WEiSi 


i-ifcA i i 1 i i i i i i 


in i i i i i i i i i 1 


I i I i l i 


i i rH ii 


nil |T|D|Xi+|l|2| i i 


in i i i i i i i i i 


RifiRQ i i 


i i iRlEft 


i .WiKidhA mi 


mi in i i i ii i 
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The expression in the operand field must result in a determinable value at 
the time it is evaluated. The value may be either positive or negative. 

A RES line is used to set aside areas for any programmable purpose , or to modify 
ah address counter. The Assembler does not produce any generated words as the 
result of a RES operation. 

11.3.3.18 RF$ Directive 

The RF$ (Relocation Field) directive is designed to assist users employing 
the Assembler to generate object programs that differ from that established 
for normal operating conditions, see Appendix G. The directive permits such 
users to define relocatable fields within object words and to associate a 
descriptive modification code with each defined field. The statement must 
precede any coding which results in object code generation. 

Format 



Explanation 

e The number of unique relocation fields to be defined. 

e must be in the range is e £ 16. 

h -h The higher order bit position of the relocation field. 

In 

The value of h cannot exceed 31. 

1-1 The lower order bit position of the relocation field. 

1 n 

c -c The modification code to be associated with the re- 

1 n 

location field, c must be in the range 1 £ c £ 16. 

A non-relocatable field or word is assumed to carry a modification code of 0. 
Upon encountering an RF$ statement, the Assembler overlays its relocatable 
fields table with those defined by the statement. Each occurrence of the 
statement causes the overlay; therefore users must declare all desired re- 
location fields with a single RF$ statement. 

Use of the RF$ directive, as well as the WRD directive, permits programmers to 
control not only the size of generated object words but also to define known 
relocation fields within the generated words, and to associate with each de- 
fined field a modification code of their own chosing. 
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11.3.3.19 SEGEND Directive 

The SEGEND (SEGment END) directive provides the programmer with a type of 
segmentation which differs slightly in concept from the LINK capability. The 
SEGEND concept may be used when the programmer wishes to assemble a main pro- 
gram followed by one or more sequential overlay segments or when a program is 
too large to be assembled at one time. 

When the Assembler END directive appears at the end of a program, it indicates 
the end of symbolic input to the Assembler. The Assembler outputs literals, 
finalizes the assembly, initializes all flags, and clears counters and tables 
in preparation for a possible new assembly. Nothing pertaining to the just- 
finished assembly survives this process. However, to assemble successive 
segments back-to-back, which are actually segmented parts of a single operational 
program, is made possible by the SEGEND directive. The SEGEND directive in 
this case replaces the END directive on all segments except the last. SEGEND 
informs the Assembler that the next immediate assembly is a segment of the 
current assembly. 

Format 

| , i iSgi6i£iM.Di 1 i i i i i i i*i iFlOiftMAiT > i i i 1 . ■ . i i i i i > 1 

The SEGEND directive causes the Assembler to retain certain information from the 
just-finished assembly for use by the succeeding assembly. 

NOTES 

a. All assembly-level labels which have been suf- 
fixed with an asterisk and their associated values 
are saved in the Assembler's item table so they 
are available to the next assembly. 

b. Address counter values are not reset to zero; 
instead they have the highest value attained from 
the just-finished assembly +1. 

c. Only externally defined symbols are preserved. 
Externally referenced symbols declared via the 
LINK directive are not preserved, but must be 
redefined as required for each segment. 
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d. Macros are never preserved from one assembly to the 
next; they must be redefined for each segment. 

11.3.3.20 SETADR Directive 

The SETADR (SET ADdRess) directive instructs the Assembler to dump (generate 
sequentially) literals referred to prior to the occurrence of the SETADR line 
as defined by the subfield(s) of the operand field. 

Format 



i i i i i i i i i 



iSfiTfAiPiRi ie 



i i i i i i i i i 



fAR ^i AT i 16I i i i i i i i 



Explanation 

e Always coded. 

aj through a n (Optional). When present, specify each 

controlling address counter whose literals 
are to be dumped. 

Literals controlled by the currently active address counter are always dumped 
and need not, therefore, be included in expressions a-j through a n » After 
literals have been dumped, the value of the currently active address counter 
is set to the value of expression e (normally the start of the next 8,192 word 
base) . 

Examples 

i SETADR, ,02.00001 , , i , h L,im \i i I i , . i . . i i ■ I 



gfeTAQR 1040000, v 3, i i h LiTUfi iZ i I i i i i i i i i i 



Line 1 causes the Assembler to dump literals under control of the currently 
active address counter, then set the counter to 020000. 
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Line 2 causes the Assembler to dump literals under control of the currently 
active address counter and those under control of address counter 3, then set 
the currently active address counter to 040000. The value of address counter 
3 must be separately advanced if desired. 

Thus the SETADR allows the programmer to ensure that literals and coding 
referencing them are assembled into the same 8,192 word base group. 

The SETADR operation has the effect of erasing dumped literals from the 
Assembler's item table. Consequently, identical literals may occur under the 
same address counter but in different SETADR groups. 

The Assembler automatically dumps all literals for all address counters when 
it detects the end of the assembly delimited by the terminating END or SEGEND 
directive. 

11.3.3.21 WRD Directive 

The WRD (WoRD) directive is written with WRD in the operation field and a 
single expression in the operand field which indicates an object computer 
word size in bits. The value in the operand field may not exceed 32. 

Example 



iWiRjOi 1 1 


iti 1 i i 


. i i • i i . I* i iFCRMAiT ill 


.i i i i ii i i 1 




ii 


i i i i i i i EKAMPiLiEi I i 


i i i i i i i i 1 



The WRD directive defines the object computer word size to the Assembler. 
It is not required when the object word size is 32 bits. Its primary use 
is in causing the Assembler to generate for other than 32-bit word lengths. 



Expression evaluation within the Assembler is carried out modulo, and the 
object computer word size sign is extended as required for single or double 
precision values with truncation occurring at the point of output. 

Once the WRD directive is encountered, it takes effect for all subsequent gen- 
erated words until another WRD line is encountered. 

. ' i 
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11.3.3.22 TAGTBL Directive 

The TAGTBL (TAG Table) directive causes all assembly labels other than labels 
purely local to a macro to be output to the object output. This output will 
be ignored by the CMS-2 Loader. 

Example 

1 I iffaffnflfllj I I Itl \riiQ\T\E\S\ 1 j i I I ' 

11.4 MACRO STATEMENTS 

A macro within the Assembler framework is an arbitrary, programmer-defined 
guide in generating object code. A macro may be thought of as a sample sub- 
program whose characteristics are generally defined in the formal parameter 
references. The actual values for these parameters are supplied when the 
programmer instructs the Assembler to generate for the sample. 

Programs can, of course, be written without using macros; however when 
repetitive coding sequences occur, it is more efficient and minimizes errors 
to define the coding sequence just once and let the Assembler produce object 
words based on the definition. Generation may vary from one call on a macro 
to the next depending upon the values furnished for interpretation of the macro „ 

Macro sample programs must always physically precede any call on them. When 
the assembler encounters a macro directive line, it, saves the associated 
sample through its END line, making use of it only when it is referenced. When 
a macro is referenced, the Assembler in a sense interrupts its normal sequence 
and commences generation at the designated entry point in the sample. When 
this sub-assembly is complete, the Assembler resumes its normal sequence with 
the next symbolic line. 

11.4.1 MACRO and END Directives 

Each macro sample begins with a MACRO directive and terminates with an END 
directive. Both must always be present to delimit the macro sample. 
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Format 



k MACRG IP£ittm l IiTJ.QHI 1HA1S1 iTiHfi 1PP1RMA1T1 , , , , I 



1 1 1 



i i i i i i i i i»I«i*i i 



i i i 



WlHiCiRgi »i, i,i jump, , 



Algid .OiPiTlCQHAIL 



I I I I I 



i i i i i i r rn i i 



I I I 



I 1*1 



I I 1 



I I I I I I I I' I* 1*1 I I 



i i i i i i i i 



Mil 



I I I I I I I I I l l I I 



I I l 1 I I 



1L 



A MACRO directive line must have a label. The label should be suffixed by an 
asterisk if the call on the macro is via the MACRO line. 

Example 

,TH,g, .KQLllOMXHG, MACRlQ .Rg.FEftE.HClg. CAAiSfS. ,1 

1W1 iWrtWOT TO iG^gjRA i r^ i fjOR flAfiRfl i ll., . , , . 
ZfiS.T, AT lT,Hig, .PQgMT toH£,R,E. iTiMifi IC.A.LL, Aif.P£AlR,S, 

1 1 1 1 1 iZiEshn i 1 1 1 1 1 1 1 1 1 i i i 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 i i i 1 1 1 i 

It should be remembered that a macro reference (call) line merely supplies 
actual values for the macro when any are required. Generation results from 
matching the actual values of the reference line to they symbolic values within 
the macro sample coding. 

The basic element of a macro reference line is called a subfield. A string of 
subfields separated by commas is called a field; fields are separated by spaces. 
Data supplied in this manner are considered to be the actual values to be sub- 
stituted within the macro sample coding where indicated by the use of symbolic 
representations. These representations are normally subscripted indexes to 
elements of the referencing line. These subscripted indexes are called para- 
forms (parameter reference forms). 

A macro directive line may also have an address counter declaration associated 
with it. The address counter declaration defines the address counter under 
which the macro is to be expanded. After the macro has been expanded, the 
address counter is reset to the address counter active at the time of the macro 
reference (call) line. 
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Format 

toftti)i»iAr* uMiaflo ih i i i i i i i i i i i i i i 1 1 , , , , , i 

11.4.1.1 Paraforms 

Paraforms are the means within a macro whereby the programmer references a 
specific parameter or group of parameters which may be found within a reference 
line calling on the macro. A part of each paraform is the label of the 'MACRO 
directive line. A paraform may consist of the label alone, a label plus one 
subscript, or the label plus two subscripts. Examples follow: 

a. The most common paraform is label (x,y), where label is the label 
of the MACRO directive line, x is the field number, and y is the 
subfield number within field x on the reference line. Thus, 
ZEST(2,1) indicates that the first subfield of the second field of 
the reference line is to be substituted wherever a:ST(2,l) appears 
in the sample coding of macro TEST. The following example 
illustrates the use of two fields, assuming a 30-bit object word 
size. 

Example 

\EM i i i i i JrtlA&jRiQ i i i i i I i i i i i i i i i I i i i i i i i i i I i i i i i i 



n^M i i i i i inutm i i ifi^jPijiMiybijifa i i i i i i i i i i i i i i i , , . , 
i i t i i i i i iflliUi i i i AI£\Zi*££\(\li+\\\\\i\BlE(A\.&)\*\l\ i 1 i 


i i i i i i i i i 1 i i i i i £!Ei(ilLi2i)i%iEiBi(i2ki2l^%iEi&(i2it!li)i !•« . 


i t t i 


-L-LJ 1..J 1 1 1 1 1 1 1 1 1 1 lEMlD 1 I 1 I 1 1 1 1 1 1 1 1 1 ! 1 1 1 1 1 1 


.1 1 1 III 1 1 1 1 1 II 1 1 1 1 ll 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 . I 
•i MlltEN, \rm *S££M&L£.RI DfiTfCtS, iTIHiB \BA MACRO , 


I 1 1 1 
1 1 l i 


.i .LXN£„, lITI ,fi£,CO,feD6. ,TIM£ ,SAMPZ.£, Iftotf, L^£, MfMl£M 


i i i i 


•i 1I1IT OA fiUfeft£«U,6iM,T|L,V| \Rfoffo*0MlSto-\ \TM\ nil,,,, , , 


•i *£.fie«BrtCl£, LXHE MASI ££, , , J*l, m«,£, .ORCRATIHOM, , , , , 


•.. fX£LSk fo\LLt>W£& AYi fr,W<0, ,FJ£iLDSI , Of t X\U^B\ 


.TWO. 


•i SUAfZeitiSi XUi .T.ll^i ,OlP£,l?AK,D, ifiltfL.D,., , i i i i i 1 m . , , 


> i i i > i i i i 1 i iFiZfii.iQ id IFXCiLiDi i2i i i | i i i i i i m i 1 i i 


Mil 


I i i i i I I i 1CI61 i r \ ili4t|i(N|iil i i§T) i^i?" I 1 i h fi*i p i i i 


1 1 1 j 


•. ilWA iP^EiOSUA RCFfiR£N,G£, ,Lttli6l .RfiSMiL,T6, uUtt , 


1 1, 1 J 


i6fiM.E.BA.TillO.II Gf\ .OCTiAlL , 6,5,3^2,6,1.41 , , MJCftE , . 


1 1 1 J 


•Ml* iWiPiiAlCfiSi ifiCi<i^i|iH)i)i ill i*iffiPitiAlCi£i$i -|*|ff|<i»iii9l)iM 


1 1 1 i 


•l A ifefiRLiAiCJUiSi i£i£,^iIi%,2i)I.i lAtiifi AO iQUj. i imi.ii m 


llil 
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The writer of the EE macro could have written it to expect one field 
of five subfields. The resulting generation would have been the 
same, but the macro sample and the reference line would then have 
been coded as shown in the next example. 

Example 





. i . MlAiGRQ_i 


» 1 l 1 1 1 1 1 1 ■ 1 -LJ_ 


..1,111111 i_L 1 1 1 11 


ELUj_l_l 


, , . iPIOiOM i 




i I 1 I 1 1 1 1 1 1 1 1 l 1 I 1 


Mill 


i i I iFDCiUi i i 


.aiSiZi, £i&dii T iii) 


i|i£l£iMl^l3l)l 9 l|l 1 i J — J — L 


Mill 


f iti i i i i 


\E£(\\\\\2\)\,££L1 


lji&IV,ljl Mil 11 1 I 1 M 


Mill 


i i i i i i i i 


££Mlji4i)i i i 


i . 1 i l*i 1 I I 1 1 1 1 1 1 . 1 1 


Mill 


i i i i£tliiDi 1 i 


1 1 1 1 1 1 1 1 1 1 ±_L_ 


I l i 1 1 1 1 11 1 1 1 1 1 1 1 


,1111 


i > ' ' ' i 


1 llAllfclylllfl 9 !)! 1 ! 2 -! 





b„ A paraform can be written label (x) , where x is the field number. 
The value resulting from such a paraform is the number of subfields 
found in field x on the macro reference line. 



Example 



., As&UMe rnHg, ,PiQL,CiO,waM,G>, ,li,h£, xni macra w,zi , ,., 

i iDA iPitiZi(tA|)i=3i 1,1 Mi iTI^iQ , i i i i i i I i i i i i i i i i 1 , , , 
Jfi J.H.S WlUHftEft Afi ,S|UftF l J,g,L l D l S l JIM, ffCflLA ,1, lOf. , 
.W, rf.II.H6l ,ReiFg|Rg,M|Cjm,Gi MiA,C,g,Q ,F|X,X, J,S, .3,,i JlHfe ■ 
J^,S.T l ftU£,T|J l OiM l ,L,Ai ffrfll ■ ■ ' INCWM fig, &£M t gA,T,E|D, , , 
iSLMiCfi ,3, HiS iS l a l B6.TJ,HU l T,E,Di ifiQft iFII,ZiCi>i)i ■&£,-! I i , i 

■ i .GA.UiS.fi iTiHIEi lEiQUiAiTJiQMl .3.»3. J.& .T.RthE^. .Rg&ti.C.Tim.G, 

»■ w rmg.-.cg.KS ,t,q ftg. iDAM.gi .BgaM^i .pppaggwi.. , , 

. i .HiAiO. T.Hfi JMMBB*, OF. ISUflf I.E.CSS, ffiH, ,FJ£,LD ,11 , , 

.. .or frMMSWX, .Lang, &sm .orr.ite* ,T,Ma ia„. 

.,.,T,Hg, gfl.UNT.IO.N, ,WflU,liP| iHAiVfi AB6M ,FALAf. .AWQ , ■ 
iT,H,E, JLjm ,TA BA.DCm .WQAIiLiQ iNiOTTi ,B&aH, ■ 

•i iP^QCjfiSSi^ ! i i i i i i i i I i i , I , , , , , , , , , I i i 
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c. A paraform may consist only of the macro label without any sub 
script. The value resulting from such a paraform usage is the 
number of fields submitted on the macro reference line. 

Example 



;j_ISei3|u R B| nine iWiUUiOWIIN*). £>M| MiAiKidO, 1F1XZI , , 
1 I I 1 |P|0| |F|I|2j=i3| in iMi ilkiQ i i i i i i i I , i i i , i i , i | , , 


•I i3i iFffflLiDSi 1A1R1E. .PiRiES.fi.M.T, CM, ,TIH£, L,\M& . . 1 . . 


•, ,FXZ„ 


iT|H£i ,ClQWi0iIT 1 3|0,M, XS XfUi£ 




AMD, ,U, ,71, A W,CWJ,IA Ale 1 6,E,M£,RA,T,£lO| ; , ATH,£fc-, 




•, ,WJ,S£, ,T,H£I .CAUDXTXAMl ,FA,L&£.I .AJJJ5, 




JLA .7,, A .WlOA.l.O ,MAT, 


,8l£, 1 fi£*i£,RAT£lD,. , , , 


d. When a paraform invol 


ves two subscripts; for example, FITZ (1, 1) 



the programmer may code an asterisk preceding the second subscript; 
for example, FIX(1,*1). The asterisk preceding in this context has 
the effect of true (value is one) or false (value is zero) depending 
on whether or not the corresponding subf ield of the reference line 
is preceded by an asterisk. 



Example 

, . . . rh i a4|C,FJiZ^l l , l »til l mAA0 l 0fl0A-h-HFJ.Z l (,l„ili),) 



I I I I I I I I I I I I I I I I I I I 



I I I I 



III II 



i in lEiMtQ i 1 i i i i i i i i i I i i i i i i i i i I i i i i i i i i I 



iii. \FXZ i I i iQIOiOQ i i 1 . i . n 



Li 



i i I i i l i i 



H1A 1 V 1 6I 



I ii i ii i 



VALiUfi &F1 aE.RO, iSIiMiCE, ,FJ.2.( 



\\ >t*\ \) 



I i l I i l i i 



»i JiSi 1FALS1S i i i i i i i i i 1 i i i i i 



i I I I I I I l 



i i i i i 



i i i I 



ii i i i i i i 



i ill iFJZi i >fll|0|Ofl I i i | i i i ii 



I i I I i mi 



.WILL, ,C^UlS,6 ,BXZM,iWU, ,TO, 



HiAiVfl 



■TiWfc iVA»LiUi£ 



>, &I,N,efi .SAllB.FXSL.D, ,1, .OIF ,FX,ELD. ,1, 116. ,S,TA,ftgf,D 



AH ift JFm< lli |»M i ) i ,ffiSi iTlH .6R|g | Ffflft €l i TOfi i M ill 



NOTE 

Paraforms may not be used as labels in the label field of any 
symbolic line. 
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11.4.1.2 Starred Labels Within Macros 

Suffixing a label with an asterisk in a macro externalizes the label and makes 
it available to the main program as well as the macro which contains it. For 
the purpose of this discussion, assume that the main program is defined as 
level one, and the macros are definod as level two. A single asterisk suffixing 
a label in a macro externalizes that label, making it available within the main 
program level. Any label defined for the main program is also defined for any 
macro. 

11.4.1.3 Operand Field 

The operand field of a MACRO directive line may contain no subfields, one sub- 
field, or two subfields separated by a comma. 

Format 

MflSltti i MiAlGRQ i icmiftial n iFPRMAiTi 1 i i i i i i i i i I 

Zero, one, or two expressions may appear in the operand field of the MACRO 
directive. The first, if coded, is the maximum number of fields which may be 
submitted to the macro on a macro reference line. Knowing this, the Assembler 
can terminate the scan of the reference line operand field once the maximum 
number of fields is encountered. If fewer than the maximum number of fields 
is submitted, a line terminator (the period space convention) must precede 
any comments on the procedure reference line. 

The second MACRO directive operand, if coded, is the exact number of words to 
be produced by the macro. The second operand must be omitted in the following 
situations: 

a. If forward references are made in the macro. 

b. If external definitions are made in the macro (except entry points). 

c. If the macro should generate a variable number of lines. 

d. When a change of address counter control, however transient, occurs 
within a macro. 

e. When a label on a macro reference line is to be assigned to a line 
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other than the first line of the macro. 

f. When the macro generates half-word machine instructions. 

Except for the conditions stated above, the second operand should be used 
because it eliminates one assembly pass on the macro, thus shortening assembly 
time . 

e^ and must result in determinable values at the time they are evaluated. 
To further understand the power of the procedure, two more directives, NAME 
and GO, are explained in the following paragraphs. 

11.4.2 Other Macro -Oriented Directives 
11.4.2.1 NAME Directive 

The NAME directive is usable only within a macro. It serves as an alternate 
entry to a macro or as a forward or backward reference point within a macro. 
If it is used as an entry to a macro, it may also define a value associated 
with that entry point. 

Format 

|LiAA£iLrH I i 1MIAME1 i iei . ■ i h iPOidMiAiTi i I i i i i i mm 

It was already explained that a macro can be referenced by the label of its 
MACRO directive line. A macro may also be referenced by the label of a NAME 
directive. The label must be suffixed by one or more asterisks to define it 
outside of the macro. A reference line calling a macro by a NAIVE line is 
written with the label of the NAME line in the operation field, and with fields 
and subfields in the operand field, as required. 

Calling on a macro via a NAME label is more common than via the MACRO label 
because a value can be associated with a NAME line. Thus if a macro has 
several NAME line entry points, each entry point may have a unique value 
associated with it. The value is coded as a single expression in the operand 
field of the NAME line. The value on a NAME line can be referenced as a para- 
form. By convention, its subscript value is always field zero, subfield zero. 
The following example illustrates how a NAME line value can be used to vary the 
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macro generation. 
Example 



1 1 1 1 1 


i MA.CIR.Q , , . I .^.1 . . 1 ■■, . 


i i i i i i 1 i i i 


1 1 1 1 1 1 




i MAMIE, . il , . . . 


i i i i i i I.. 


i i i i i i 




i iNiAMlE i ill i « i i i iii 


i i i i i i iii 


i i i i i t 


i i i i i 


*M.(l0,.OW,M,M,.,l V, , ■ 


i i i i i i iii 


i i i i i i 


_LJ_1 L 1 J_ fAlDl 1 1 1 1 1 1 1 I 1 11 1 ■ t I III 1 til 1 lit 1 


i i i i i i JAR i iOIiOOQ i i i i i i i i i i i i i i i 



iftEi&ULiTS 11,14, iQCTAiLi idOiQOOOiQ \ ,QQ I 



i i i i kJiAMI i iQiliOiOiO i i I i i i i i i i < i I i i i i t 



I I i i i 



l 



The value on a NAME line may be preceded by an asterisk. Assuming the MACRO 
label, M, the paraform to interrogate the condition is M(O f *0). 



Example 



I I I I I I I 



I \ I 



J»Afl*> i iNiAHB i i i i i i 



i i i 



JiAM») i H\Nft£\ i i iii i i i i i 1 i i 



_L_L 



1_L 



.ulI 



J>A2W i flAMEl i iHiT i i i i i I i i i 



i i i i mw 



in 



1l±1 



i i i i i fiNA 



M ill 



1L± 



ffiHfi iB 6i fiE|P i giH i C£ i I i i i 



i i i 



i i i i i 



i i i 



i i i 



1 1 1 1 1 



J.AiM| I . i O. I OOOi i I i i i i i i i i i I 



i i i 



The value on a NAME line may itself be a paraform only if the NAME line is 
contained in a nested macro. 

The programmer may incorporate additional subfields in the zero field. 
Values to be associated with the zero field are coded as subfields in the 
operation field following the entry label. These subfields are expressed 
within the macro as label (0, *label subfield number). Remember that field 0, 
subfield 0, always refers to the value, on a NAME! line. 
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Example 

F, , i . ■ MAdRA 



I i3i i i i i«l MAXIMUM iQFi 3, fiXfl-fiSI 



I 1 I 



FA* , , iMAHIB 



i l i l I i i 



» I » II I I » I l i l I I i I I 



i i i 



1— L 



i i ii ii 161Q I rtFiXi i i i i i I i i i I ii i i i I i i i i in i i 



i I i 



I I l I I 1 I 1 I I I t I I I i | I ' i -l I '»» I I I > I 



I I I I I I I I I 



1 1 I I I I I I I 



II II' 



FOiRiWARID. ,R£F£RCKCE, 



J L 



I I I I I 



i i i i i i i i i i 



I I I I I I I I I 



I I I I I I I I I 



J__l 



I I I I I I I I I 



I I I I I III I 



I I I 1 I I I I I I I I I I I I I I I 



I I I 



SAMPLE ,RlEf ERfMCE ,LlI.M£,S, 



I I I I I I I I I I I I I I 



I I I 



I Mill 



MiFA l i i A»A 1 ^17,3, , a 



I I 1VI I I 1*1 



I II I I I 



MFal ! flli3,, l L l B,L8&l )l a2 



I I I I 11*1 



The count of fields obtained by using the paraform consisting only of the 
MACRO label includes field zero in the count only when entry is via a NAME 
line. Entry via a NAME line implies at least one field, field zero. 

A NAME line may also be used as a local reference point within a macro. 
11.4.2.2 GO Directive 

The GO directive transfers Assembler processing to the label in the operand 
field of the GO line. Th e label may only be a NAME label or a starred MACRO 
label. GO provides the mechanism for forward or backward referencing within a 
macro. By inference, any entry to a macro must have a starred label associated 

with it (see paragraph 11.4.1 and 11.4.2.1). Externalizing a label is a 
physical attribute. For assembly purposes, macros are presumed to be nested 
within the main program; one asterisk overrides this nesting. If a macro is 
physically nested within another macro, it is one level further removed from 
the main program. To externalize a label within this innermost macro would 
therefore require one asterisk to make it available to the outer macro and 
another asterisk to make it available to the main program. 

A special word of caution is necessary when discussing starred labels contained 
within a macro physically nested inside another macro. A starred label within 
a macro nested within another macro is not externally defined (or referable) 
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until the macro containing it has been referenced. 
Example 

■GO I .LAftEL. i i , 1 , ,», .FQRMAX1 i , i , 



i i i r 



a 



i n 



IQ/./iQ i ■ i i ■ I ■ mln 



Dft 1 1 H(ili)i3)|g|li i)l 16Q SJA 11 



IPO 1 1 Mdti 



If 



awi i,i fifi 1 1 1 1 1 



Mif iQ, iQVm f 1 1 1 , I+Q4M d 1 1 , 12,). 



I I I I 



16Q 1 1 IAiLL 



1 1 I 1 1 1 1 1 1 1 1 1 I 1 



1 1 1 1 1 I 1 I 1 1 



1 1 1 1 


1+1 1 1 1 H(\0\ f 




,i!i)i+6+Mi(i'i> 


i > 




1 1 1 1 


£A . . lAtLL 


1 1 1 1 1 1 


1 1 1 1 1 1 1 1 1 


III! 






, NAMEI , , , 


1 11 1 1 1 


1 1 i.i 1 1 1 1 1 


1 1 1 1 




MM 


1*1 1 1 1 Mi(iOi| 


.Q).*MO 




12,) . 1 




AU4*i 


MAM 6 1 1 1 


1 1 1 1 1 1 


1 1 1 1 1 > 1 1 1 


1,,, 


1 1 1 1 1 1 



I I I I 



1 1 1 1 1 I 1 1 1 1 1 1 1 1 1 1 1 1 



A NAME label serving as the destination of a GO must be suffixed by an asterisk 
if it is a forward reference. 

11.4.3 Summary of Macro Usage 

A macro describes to the Assembler the format and manner of generation for one 
or more object words. Input to a macro consists of parameters, which when 
substituted within the macro, either result in object generation and/or 
conditionally affect the generation. 

A macro begins with a MACRO directive and terminates with an END directive. 
Entry to a macro may be via the MACRO or NAME lines. MACRO and NAME lines 
require labels. An asterisk appended to a MACRO or NAME line label defines 
it as an entry to the macro or a forward reference within the macro. 

Macros may be nested within macros. Reference to nested or non-nested macros 
may be made in a macro only if its definition was encountered prior to the 
reference. 



11-11-49 



M-5035 
Change 5 

All directives (except LIBS and LIB) may be used within a macro. 
None, one, or two expressions may be encoded in the operand field of a MACRO direc- 
tive line. The first is the maximum number of fields which may be expected on a 
reference line, and the second is the precise number of object words which the macro 
generates. The second expression is never coded if the first is not coded. If the num- 
ber of fields is variable, the operand field is empty. If the number of words generated 
by the macro can vary, or if the macro generates half-word instructions or affects 
the currently active address counter control or contains forward references or exter- 
nal definitions, the second expression must be omitted from the MACRO line operand 
field. Comments on a MACRO directive line must be preceded by period space. Good 
programming practice implies that detailed comments be used to describe a macro, 
including its purpose and the expected order and contents of a line of coding which 
references it. Such comments should be encoded as pure comment lines outside the 
macro. 

11.4.4 Special Consideration When Coding Macros 

11.4.4.1 Comments 

Comments on macro reference lines and macro coding lines should always be pre- 
ceded by a period space, whenever the expected number of fields or subfields may 
vary. When extensive comments are desirable, it is good programming practice 
to code several purely comment lines preceding the macro. 

11.4.4.2 Labels on a Macro Reference Line 

A label may be present on a macro reference line. Under normal conditions 
this label will be defined equal to the value of the current address counter 
at the time of the macro call. It is possible to alter the positioning of this 
label within the macro; that is, it is possible to associate this label with 
a line within the macro. This is done by coding an asterisk (*) alone in the 
label field of that particular line in the macro definition. The label of the 
calling line will be processed exactly as though it had appeared in place of 
the asterisk, except that it will be defined at the level of the reference line 
on which it appeared. 
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Example 





MACRO 


i iliji2i i i i i 1 i i i i i i i i 


i 1 i I i i i i i i i 


i i i 


\ M \ \ 


i i liddli^il^i^idli^iZ)! i i 


i I i i i i i i i i 


H i i 


Ji i i i 


i A+di i i t I i 1 i i i i I i 


i i i i i i ii i i 


i i i 


ENQ , 


■ i i i i i i i i i i i i i i i i 


i i i i i i i i i i 


RAM 


1X1 i i i 


i i3i>iZAL,E|N,CE i M i i i i 


i i i i i i i i i i 


1 1 1 


|I*A i i 


i &41R1AM ii i i i i i i i i 


i i i i i i i i i i 



In this example, RAM is the address of the J line. If this line has not 
included the asterisk in the label field, RAM would have been the address of 
the JZ line. 

11.4.4.3 Address Counter Declarations Within a Macro 

No change of address counter number is permitted during the expansion of a 
macro except that governing the generation of in-line constants or literals. 
Changes of the latter type are made via the LIT directive. 

11.4.4.4 Externalizing Labels 

The nesting of macros is permitted up to 29 levels. This nesting can take 
two forms : 

a. If a macro definition is completely (physically) contained within 
another macro definition, it is explicitly nested in the larger, 
and the internal macro is considered to be one level higher than 
the external macro which contains it. This type of macro may con- 
tain other macros. An internal macro may only be referenced after a 
call has been made on the external macro. 

b. A macro which is called upon by another macro is said to be nested 
within the calling macro at the time of reference. If a GO statement 
transfers control to an entrance label of another macro, this is not 
considered nesting but is a lateral transfer and does not change 
levels. 

The value associated with a label contained in a macro may be defined for use 
outside of the macro by suffixing the label with an asterisk. A special con- 
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dition applies to labels contained within macros physically nested within outer 
macros. One asterisk defines a label for use by the next outer macro. Two 
asterisks define a label for use by the next two outer macros, and so forth. 
The skeleton diagram which follows illustrates this method of propagating a 
label value through the use of suffixing asterisks. 

Note that externally defined labels are not defined outside the macro containing 
them until that macro is referenced. Label Dl remains undefined to the main 
program until B t C, and D are referenced, in that order. Al is not defined 
until A is referenced. Once defined through a reference, Al and Dl are avail- 
able, thereafter, throughout the assembly. 



A* 
Al* 

A2 



MACRO 

EQU 6 
EQU 5 
END 
MACRO 
MACRO 
MACRO 
+6 
+8 
+10 
+12 
+A1 
♦END 
D 

+D4 

+A1, Dl, D2 t D3 

♦ END 

C 

+D3, D4 
+D1, D2 
+A1 

♦ END 



REFERABLE BY B AND MAIN PROGRAM 
AVAILABLE OUTSIDE A 
AVAILABLE INSIDE A ONLY 



_ B * 

i— C* 
r D* 



REFERABLE BY A AND MAIN PROGRAM 
REFERABLE ONLY BY B 
REFERABLE ONLY BY C 



Dl*** 

D2** 

D3* 

D4 



DEFINED FOR MACRO D 



C REFERENCES NESTED 
UNDEFINED FOR MACRO 
DEFINED FOR MACRO C 



MACRO D 
C 



B REFERENCES NESTED 
UNDEFINED FOR MACRO 
DEFINED FOR MACRO B 
DEFINED FOR MACRO B 



MACRO C 
B 



MAIN PROGRAM CODING LINES 



MAIN PROGRAM REFERENCES MACRO A 
MAIN PROGRAM REFERENCES MACRO B 
DEFINED FOR MAIN PROGRAM 
UNDEFINED FOR MAIN PROGRAM 



A 
B 

+A1, Dl 

+A2, D2, D3, D4 
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11.4.4.5 Macro Reference Lines 

Macro reference lines (calls upon macros) are coded following the normal 
Assembler syntax governing fields and subfields. A macro reference line may 
be labeled. The label is normally equated to the address of the first word 
generated from the macro, but may be equated to any line within the macro by 
coding an asterisk only in the label field of the line. The macro is called by 
writing the entry label (from the MACRO or a NAME line) in the operation field, 
followed by as many parameters as may be required in the operand field. Para- 
meters are organized into fields and subfields according to the requirements 
of the macro. Subfields of the operand field are assumed to be parameters of 
field 1, field 2, and so forth, in left-to-right order. Any subfield may be 
preceded by a single ast3risk to be used as a conditional value within the 
referenced macro. 

An address counter declaration may be coded on a macro reference line. This 
declared address counter will supercede any address counter declaration made 
on the macro directive line. (See also Paragraphs 11.3.1 and 11.5.) 



11.4.4.6 Complex Macros 

Macro capabilities provide an extremely powerful technique for controlling 
Assembler generation. Macros can be simple or complex limited only by the 
programmer's ingenuity. The example which follows of a more complex 
macro may be used to generate for data word lines assuming a 32-bit object 
word size. 



Example 



fcQU ai2/,ZAM,), ,., IN,Q Of, PARAMETERS 



I, F.XELQJ ,1, MtQftQ 



i_J_ 



IXCl 

1 L 



l_l 



RQRM I iYi8ijiY]Bi|iYiB)iyftj 
Xi C i I I . Z Adliyli ) j iZIAiM 



i i i i i i 



i i i i i i 1 



ZAIi li)4)i)i£lAi(ii 



gACV 7 ,) i,i2A(,l 



i i i i i i i i i i i 



J_L 



Yi6 1 Y &| YIBif iYiB 
fi)i>ZA(l>i| ife^ 



it 1 1 1 I i i i 
i i i i i i 1 i i i i 



>i i i i 



i i i i 



>i i 1 1 



i i i i 
i i i i 
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The following macro example generates an overlapped bit -field object word for 
an 18-bit object word. 

Example 

g i i i MAC1R1OI i'i>ili i i m H i l l i FffitiP i i i Hi NOiRA nil, 

[ENMi i MAME I O i i i i i i i l i i i i i i i | i 1 i i i i i i i i i I i 

ftUiTft NiAiKS 1 ft i ii i i i i 1 i i i i i ii i i 1 i i i in i i i I i 

» i i i iWtftDi i | i>i& i i i i i i I i i i i i i i i i 1 i i i i i i i i i I i 



hMi i i FORM 1 iSui2li2uAi i i i i i i i i i i > i i i i i n i 1 « 


i i . i iFMi . i 1 iaS.2,;MY.0 5 0l).4r»-Yf1 l (,l. 


ii2li)ltM^iQ4i)i/i<Mi)i;l}i 


i i i i i i i i i 1 M(ili«i2i)i*MD3i«Mi(ilif ill 


III 1 1 1 1 ! 1 1 1 1 1 i 


i i i i £MDi i 1 i i i i i i i i i i i i i i i i i i 1 i i i i i i i i i i 


•i SAftPtfi iRlEiFfiRGNCfiS 1 i i i i i i i 


II 1 1 1 III 1 II i 


in i IN i i 1 &Uff\^l\ i i 1 i i i i i i i 


1 1 1 1 1 Mill II 1 i 


m m AUTu WJifiFAiii4 i i i n i l l 


II 1 i 1 I 1 1 1 1 1 1 i 



11.5 ADDRESS COUNTER DECLARATIONS 

The Assembler provides for 32 address counters, and any one may be referenced 
or used. Grouping of constants and/or instructions under a given address 
counter may be more convenient or meaningful for segmenting purposes or for 
collecting coding groups at load time. A specific address counter is declared 
by coding in the label field: 

Format 
$ (e) 

Explanation 

e The address counter number (0 through 31). 

At the start of an assembly/the Assembler assumes address counter is active. 
All address counters have an initial value of zero. A declared address counter 
(counter if no other has been declared) remains active until a new address 
counter is declared and all coding following the declaration is controlled by 
that counter (assembled relative to zero). Coding resumed under a previously 
declared counter continues at the next sequential address following the last 
one used under the counter. 
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Examples 



MM 


MM lMA| | | 


1 l7)l*lfll 1 M M M 1 


i !•! ( L,I,Wfi |l| i | | 




i m i iSIAi i i 


i i2i>iCiArr|C|ty 9 i3i I i i 


i i»l LINE iZ i i 


1 1 1 


mm iSlNAi i 


i ft) iCATICMr^i* i) i3i 


i i*l iLIiMiG i3i i i 


ft ( ill) 




1 |l|OPl 1 M 1 M M 


i i-l iLjZ|M|E| i4 i i 



11.6 EXPRESSION STATEMENTS 

An expression is an element or a series of elements connected by operators 
which, when evaluated, produce as a final result a binary value, a floating 
point number, or a memory reference address. The final value may be used as 

a word(s) of data in memory, as a subfield of an instruction word or data word, 

or as a parameter for an Assembler directive. 

An element is a grouping of characters which is recognizable to the Assembler 
as an entity and can be replaced by a binary value, a floating point number, 
or a memory address. An element may be: Da symbolic name, (a label); 2) a 
decimal, octal, or floating point number; 3) the contents of an address counter; 
or 4) a literal item enclosed by parentheses. A detailed discussion 
of element follows. 

An operator is a special mathematical symbol defining the operation to be per- 
formed on the operands immediately preceding and immediately following the 
operator. An expression need not include any operators if it consists of only 
one element; however, if more than one element is included within an expression, 
they must be separated by operators. 

Expression evaluation is normally performed in a single-precision mode (single- 
precision normally being 32 bits, unless altered by the WRD directive). How- 
ever, if any numerical element of an expression is terminated by the letter D, 
the remainder of the evaluation shall be performed in a double-precision mode, 
with a double-precision result generated. 

An expression is terminated by either a comma or a space; therefore these two 
characters cannot be included within an expression. The one exception to this 
rule is the use of character strings as elements. These are further explained 
in the following paragraphs. 
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11.6.1 Labels 

An alphanumeric label may be used as an element within an expression. The 
label must conform to the rules for labels as described in paragraph 11.3.1.1; 
for example, it must not exceed eight characters; it must consist of alpha- 
betic (A through Z) or numeric (0 through 9) characters, or $; and the label 
must begin with an alphabetic character. 

When the expression is evaluated, the value allocated to the label is sub- 
stituted in the expression. If the label is undefined at the time the expression 
is evaluated, it is assigned a value of 0, and a U error flag appears on the 
assembly listing adjacent to the line referencing the undefined label. 

Example 



z , 


i i i i i i lElQUt i i i i i i iOIZA i i i i i i i«l ili i iiii i i 1 


BIT62, i i i iGQU i ! ■ i ■ i ZlfciZi • t ■ ■ i « 1 2i i > i ■ ■ ■ i 


i iiii i i i REiSi i i i i i i oIIiTEiZi/ Zi i i i»l 3i ■ i ■ ■ i i i 


i*i 


AJLME ,1, toEFXMSS, .THIS, LAtelL, ,2 , , 




,LIM£ A beFXHE&, XHIC, LABBL, r mTEZ,, A.HD, 


I* 1 


ALSO USIBS, Z AS, AMI E,LEMERt, , ......... 


!• 1 


TM THfi ftXPRESSlftMl ,,,,,,,,, 1 , , ,. 


!• 1 


,L2W£ ,3, USE& TME .UkAfiL.,. ,BXTfi2, t , AS 


n 


iAiMi lEjLiEiMIEMiTi 1O1F1 iT>H£l BXiPR«iSSffOmr i i i i i i i i 



11.6.2 Address Counter 

The contents of any address counter used by the program may be referenced in 
an expression by coding the symbol, $ or $(e). $ signifies that the contents 
of the current (active) address counter are to be substituted in the expression; 
$(e) signifies that the contents of the address counter specified by e are to 
be substituted, e must be an octal or decimal number, or an expression 
resulting in a binary value. 
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Example 

I l I 1 I i 1 1 I l+l 1 I I l i » I I I I I I I 1 1*1 ill 1 I I I 



i i i i i i i i i hh i i i i i i ii l*i (A) i i i i i i h ft i m i i i 1 



■ i i i i i i i i l+i i i i i i i i i ICAiT i i i i i i 



.« .LINE .1. IR.BF.E.R,ENCfiSl 1LZN16 A ■ 



1 * 1 .LXME a IRE1F1E1R1EHCE1SI ,T,Mfi , , . . , 1 , 



I* I I 



11.6.3 Decimal Number 

A decimal integer may be used as an element within an expression. The decimal 
number is converted to its binary equivalent and used in its binary form for all 
further computations. The integer may consist of any number of decimal digits; 
however the final binary value represents only the least significant bits of 
the number as determined by the object word size. The sign of the number is 
the leftmost bit of the final object word. The first (most significant) digit 
of the coded decimal number must not be zero (0). If the decimal number is 
immediately followed by the letter D t a two-word binary equivalent shall be 
generated. 

Example 



, i im iPIRiOOUCfeS iOiCJTAiLi 


.O0O6AOD.OA6.4 , , , , I 


. i ... ,PRAOU,CfiS OCITAL, 


3,7,7,7,7,717,77,57 


.+,5.1,2, , ,., FRADMCAS. .GCITAi., 




,+ASi3,2AlASID. ... iPiRODAiCI&iSi 1A1 ,TWO,-WD,RD .VA.LW.B 


i . 1 1 . 1 1 1 1 1 . I*. iEauaiL. rro i 


003,7,1,1 ISS.l ,7.1, , , , , 


i i i i i i i i i ii*. AiNA i i mi 





11.6.4 Octal Number 

An octal integer is specified by preceding the first (most significant) octal 
digit with a zero (0). Each character of the octal integer must be an octal 
digit (0 through 7). Rules for evaluation are the same as for decimal numbers. 
An octal number may also be followed by the letter D to obtain a double-precision 
result. 
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Example 



I I I I I I I I I 



r.Q3,S6 ,PIRQDUC6,S 3,717,7.1,1.714,2,1 



' 1 ' ' ' 111 ' 



, + A7 l 6M3Al to,l ,2,3,0, PftlO,DiU£E,S, ,3,&S |A,3,2,I Ol , 
i jiii i i i i I i i i i i ■ AiAlD, , , , , , 000100000,001, , 



11.6.5 Floating Point Number 

A floating point number may be used as an element in an expression. The number 
must be coded as a decimal mixed number consisting of an integral part and a 
fractional part, and must include the decimal point. Spaces are not allowed 
within the number. The number is converted to a 64-bit (regardless of the 
declared word length) floating point number, formatted in memory as follows: 

Least significant 32 bits 



□□EQffiSEEEEEEaEEEEEECEEfflEQDQaCDOQIia 



Mantissa 



Most significant 32 bits 



EacEafflaEEEmojEiaiDEEinDiniDiDinnaanonnoDa 



Sign of characteristic 



Characteristic 



S is the sign of the mantissa. 
Example 



,+,2,« |5|*i+|4, | 


hi 


,P ( R 1 I ( U I C,6 I S| 


0000,0,6,00,012,6, , , , 


i ii i 1 i 


i i i i i i I i I 


h 


|A|M,0| , , i i | 


,1,14.2,2,6*00100, , , , 


MM i 


,-,2«* ,5i*rfi6, , 


•i 




,0000000002,6, , , , 


Mill, 


i i i i I i M i 


% i 


AiNiDi i i i i 1 


,26,3 £.5, 1 ,3,7,711,1, , , , 


MM I 


fhi A'A i i i 


•i 


l Pft,0,DMC l 6,S| 


,00000000,010,4, i , , 


1 II 1 i 


ii i i ii ii i 


•i 


iAWOi i iii | 


,1,2,0^00^0, i i i 


Mill 


n'riQ-i i i i 


•i 


,PfcA0,U,C,6|S| 


000,0000000, 1 mm 


Mill, 


Mill III 1 


•i 


ANA i ml 


,2,1,1,7,7,1,1,1111,1, , , 


11 1 1 1 l 


i rr |3| i i i i 


•i 


iP|RpPMiCp|S| 


,3,1,7,7,7,7,7,7,717,6, , , 


1, III 1 


I 1 1 M 1 1 1 | 


•i 


AMD, » . 1 


,2 I 6,3 I » I 0,63M|6 I 3| | , , 


1 1 1 1 l 
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11.6.6 Fixed Point Number 

A fixed point number is an expression element containing only an integral part, 
and hence does not include a decimal point. This type of number is often 
referred to as a signed pure binary number. 

11.7 DATA MODES 

Since expression evaluation is essentially an arithmetic process, the elements 
within an expression (with the exception of character strings) must be able 
to be identified with a unique numerical quantity. This numerical quantity 
may exist in one of two formats: 1) a signed pure binary number; or 2) a 
floating point number. The resultant or final value of the expression is 
either a binary value or a floating point number. (The final value may be 
truncated to fit a specified subfield or word size at the time the generated 
object code is produced in its loadable form.) 

All internal expression evaluation is performed in one of these two modes 
(either binary or floating point). If the expression involves both binary 
values and floating point values, internal data conversions are performed 
(for example, binary to floating point, floating point, to binary) so the 
evaluation can be carried out. 

11.7.1 Literals 

A line of coding without a label field, without leading or trailing spaces, 
and entirely enclosed in parentheses is called a line item. A line item may 
only be a symbolic computer instruction, a data word, a macro reference line, 
or a FORM reference line. The object word(s) (either one or two) generated 
for the line item is called a literal and is stored in a literal pool. The 
literal pool address is then substituted for the parenthetical expression in 
the parent line. The line item must be the only element within the expression 
being evaluated, and must not be preceded by a + or - sign. If the first 
subfield of a data word line item is a symbolic name, the name should be preceded 
by a + or - to avoid possible confusion with a symbolic computer instruction, 
see paragraph 11.7.2. Six levels of parentheses (for example, five line items 
nested within line items) are allowed. A double-precision literal constant 
may be generated by terminating the numeric constant within the parentheses by 
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the letter D. If the line item is a character string, up to two words can be 
generated. 

Example 



I I*! I'l I 1 I I I I I I 1 I I 



. , jf .+flAT,, 41) 



ill li ill I 



LL-J 



iiliMiB ill ,6IE,Mi6J?A,T l e l S A tOMS.TAM.T OF, 0,70 



.1 A»Ti ■L.WEi H , JH.6 iLHTiEIRAIi AIDDiR.e.S.S, m l 



PFi ,r,Hg, ,VAUJ,6 0,70, .WfftiL, ,Bfi, frfiMlEft A.T.6Q, 



MAMf, t , ,f,2 t 0l4,a,D t ), ,P,R,0»)U0£6, A TiWO-WORD 



'nil 



LITERAL IPPPl, ,CPH,s;T|AHT. ,Q,F, 60,00,0,004,0,00. 



A.HD, ii, ,1 ,,,,,,,,, I QOOPOPOOOOQ 



Tttf, ADDRESS, 6gM£RA]r£D, ,F0fr T.HE, LXT,E,RA,L 



., Kilt, B6 mUT, 0,F, T.HE, FIRST, ,WOft,D,. 



Mini 



11.7.2 Data Words 

The Assembler recognizes two distinct types of data words: 1) constants, 
resulting in either one or two generated computer words; and 2) character 
strings, resulting in one or more generated computer words containing character 
codes . 

11.7.2.1 Constants 

A + or - in the operation field followed by one or more subfields in the 
operand field signifies that a constant is to be generated. Whenever a + or - 
appears as the first character of the operation field, any number of spaces or 
no spaces may separate the sign from the first operand. Subfields are separated 
by commas. In generating constants, the Assembler assumes the size of the 
object computer word. If the operand field contains one subfield, the signed 
value of the subfield is right-justified in the generated word. If the operand 
field contains two subfields, two equal-length signed subfields are generated 
with the values right-justified within each field, and so forth. The first 
subfield must be signed. Successive subfields may optionally be signed. The 
absence of a sign implies a positive value. If variants of this implicit 
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equal subdivision of datn words are required, the capabilities of the FORM 
directive may be used to derive the desired format. 

Example 

,-,163,64, , , 1 , , , , PflOiOUCES ,3rilX7l1,3,1,7i11i ml 

i-fi»A<i t iiOiasn, , i i»i iPftOiPyg^iSi idooiim iiiiisaoi mi 

,*,a t r^, l 2 l l l) l- l 2,8, ... ,PfiODlU£i6iSi ,0,1 Oilfelfe,! .2,14,3, ml 

If the operand field contains just one subfield immediately followed uy a D, 
or if the constant is a floating point number, the Assembler generates a double- 
length constant in two successive computer words. The first generated word of 
the double-length constant will contain the least significant bits of the 
result. The letter D in this context is only meaningful when appended to a 
numeric constant. 

Examples 

,+, l,Q P. ,., IPftOP.UCg.S, t ao,0,QO,OflOOO,4l i , i i i i i i i I i 

■i ' i i i i i i i*i 1 i i i i i i i i ,>l2,0,00.0AO.QQOl m i i i i i i i 1 i 
i-.l,fe3.84l>., IPM),D,U,C£,S, ,311,7,1,7,73,7,1,1,11 , , 1 , 

i i i i i i i i*i 1 i i i i i m i 3nni1,7i1iir>i1i17l i i i n i i i i I . 
^0,1,23,456116,5^,3,2,1,0 ,., 1PR6,DUC.6,S, .3I4,5,4>,1 * S, 4,3,2,1 1 , 
i i i i i i i i i I i i i ii, i i*i I i i i i i i i i ,O|t)0AOiOiOOAt,2j , 

11.7.2.2 Character Strings 

Strings of characters which can be represented by the Assembler's imbedded 
character set (with the exception of the apostrophe) may be encoded by 
enclosing the entire character string between apostrophes. The apostrophe 
is not included in the allowable characters because it is the control character 
delimiting the string. A semicolon between apostrophes is treated as a char- 
acter, not as a line continuation symbol. Similarly, a period space combination 
between apostrophes is treated as two characters and not as a line termination. 

The Assemblers internal character set is the USA Standard Code for Information 
Interchange, commonly referred to as ASCII code. Unless directed to the contrary 
by the CHAR and BYTE directives, the Assembler will right-justify each ASCII- 
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coded character within an eight-bit field, up to a maximum of four characters 
per generated word. 

If the first non-blank character of the operation field is an apostrophe, all 
subsequent characters up to, but not including the terminating apostrophe are 
packed left -justified into as many successive computer words as are required 
to accommodate the string. Any remaining partial word is padded on the right 
with space characters. If the object word size is not evenly divisible by 
the declared character length (see paragraphs 11.3.3.2 and 11.3.3.3), the un- 
usable bits will appear as binary zeros in the rightmost bit positions of the 
generated object word. 

If a + precedes a character string, the Assembler regards the string as a 
constant; therefore, the number of characters between apostrophes may be from 
one to eight. One to four characters yield one computer word; five to eight 
characters yield two computer words. Characters are packed right-justified 
within the generated words with leading binary zeros as required to pad the 
word. However, if two computer words are generated, the character string is 
regarded as a double-length constant and the leading character codes will 
be in the second word. 

Examples 



i+i i'i4iCfoE|\ | i i 




iiaiiiOifcisdiiiOiSi ,M,i 






,1,0,5,2,0214,3510,5, , , , i 


i i i i i i i i i ii 


i"i i i i i i iii 


,0|0|0|2A2|4i'|S|2|Z| i i i i I 






,10,1,2,0*15,1,1,0,5, mm 


1 1 1 1 1 1 1 1 1 11 


1*1 I 1 1 1 1 III 


,l^l,2i(,6l4i2,A4A , . , , 



Refer to paragraph 11.3.3 for descriptions of the BYTE, CHAR, FORM and WRD 
directives. These directives may be used to deviate from the imbedded object 
word length and eight-bit character framework. 

11.8 OPERATORS 

The Assembler provides 14 mathematical operators which define the exact sequence 
and manner in which elements are to be combined within an expression during 
evaluation. These operators serve essentially the same purpose as those 
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encountered within a normal algebraic expression. 

Similar to the rules of algebra, which assign a priority to each of its operato: 
(for example, multiplication is performed before addition), the rules for 
expression evaluation assign a priority to each of the 14 operators recognized 
by the Assembler. These priorities may be overridden by using parenthetical 
grouping, in the same way that parenthetical grouping is used in an algebraic 
expression. The rules for evaluation are discussed in greater detail under 
Operator Priorities (see paragraph 11.8.2). 

Each of the 14 operators falls into one of three classes: 1) arithmetic, 

2) logical, or 3) conditional. Arithmetic operators have the highest priority; 

conditional the lowest. 



11.8.1 Symbols 

The operator symbols as well as their relative priorities are listed in Table 
11-1. 

Table 11-2 summarizes the data formats allowed with each operator, and the 
format of the resultant value. Note that the table is divided into four 
columns, labeled First Item, Operator, Second Item, and Result. If the entries 
under First Item and Second Item for a particular^ operator specify both binary 
and floating, the corresponding value for that item may be either data format; 
however, the result is in the format specified under the Result column. The 
actual evaluation is performed in the mode specified for the result. 
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IAdLL 11-1 . 


UrLKAlUKo AIVIL) 


DDTADTTTCC r» C ADCDATrtDC 

rKlOKlllLo Ur UrLKAlUKb 


Relative 
Priority 


ODerator 


Mpani no 


6 


*+ 


B 

A *+ B is equivalent to A * 10 


6 


*_ 


-B 

A * -B is equivalent to A * 10" 


6 


*/ 


B 

A * / B is equivalent to A * 2 


5 


♦ 


Arithmetic product 


5 


/ 


Arithmetic quotient 


5 


// 


Covered quotient 


4 


+ 


Arithmetic sum 


4 


_ 


Arithmetic difference 


3 


** 


Logical product (AND) 


2 


++ 


Logical sum (OR) 


2 




Logical difference (EXCLUSIVE OR) 


1 


= 


EQUALS conditional 

A=B has value 1 if true; if not true 


1 


> 


GREATER THAN conditional 

A > B has value 1 if true; if not 
true 


1 


< 


LESS THAN conditional 

A < B has value 1 if true; if not 
true 
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TABLK 11 -L\ DATA MODES FOK OPKUATOU ITEMS 



First 1 1 fin 



Operator 



Second Item 



Result 



Binary or 


floa t i ng 


< , 


B i nn ry o r 


float i ng 




B i n a r v 






Float i nil 






Bi nary 






Floa t i nil 




+ . 


Bi nary or 


float i ng 




Bi nary 




* 


Float i ng 







Binary or floating Binary (() or 1) 
Binary or floating Binary 



Binary 
Bi nary 
Float i ng 
Float i ng 
Bi nary w 
Binary 
Binary 



© 
© 



Binary 
Float i ng 
Floati ng 
Floati ng 
Floati ng 
Binary 

Scaled Binary 



The second item for these operators must be a binary value; if not, the 
Expression Error (E) flag is set. 



11.0.1.1 Arithmetic Operators 

This class of operator includes the familiar arithmetic operations, such as 
addition, multiplication, exponentiation and so forth. 



11.8.1.1.1 *+ (Positive Exponentiation) . This operator multiplies the element 

on the left of the operator by 10 raised to the power indicated by the element 

+B 

on the right (for example, A*+B is equivalent to A*10 ). The result is 
floating point number. 

11.0.1.1.2 *- (Negative Exponentiation). This operator is similar to the 
positive exponential, except that the left-hand element is multiplied by 1/10 
raised to the power indicated by the right-hand element (for example, A*-B 
is equivalent to A*10" B or A*(l/10) +B ). 
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Example 





i i* iPiRiGOMGEIS. 


Ai 


iFiLOAiTiIKGi 


1PO1IM1T1 i 1 


i i i i i i i i i 1 i i* MOiRiOi i ill i i i i i i ii 1 i i i i i i i ii 


>3,2il,. 0*,-,2l 


, ,. flRADMCiEISi 




,Ft .OAfTiIN.6. 


|PPW, , 


1 1 1 1 1 1 1 1 1 1 


i i-WiORD, ill. 


1 1 


1 I I Ml 1 1 1 


1 1 1 1 1 1 1 


i5i^,5i 1 




A 




PAW, i 


i i i i i i i i i 1 


i ,• WiO,R,D i , i 


i 1 


i i i i i i 1 i i 


II 1 II 1 1 



11.8.1.1.3 */ (Binary Exponentiation or Scaling) . This operator multiplies the 
value on the left-hand side of the operator by 2, raised to the power indicated 
by the element on the right. If the left-hand element is a binary value, the 
effect of this operator is to shift the value left, if the right-hand element 
is positive; and to shift the value right, if the right-hand element is negative. 

If the left-hand element is a floating point value, the result of the */ oper- 
ation is a scaled binary value. If the right-hand element is a single-precision 
value, the result will be a single-precision binary value with up to 32 signifi- 
cant bits. If the right-hand element is a double-precision value, the result is 
a double-precision value with 32 significant bits. 

Example 

,+,orn,»,/s , i», ,p,RoDu,cg,si .ooflooooaiiAo, , I 

,+,Q4OQ0Pi«i/l-3i i* , .PftftQUlCgSi OAOAQOMoOA , , , , 
,44.,S,»/a ,1 PfrODUlCfiS, ,00000010,4400, , , , , I 

11.0.1 -.1.4 * (Arithmetic Product). Multiplication of two values is indicated 
by separating them with an asterisk (*). The value on the left is multiplied 
by the value on the right. 

Example 

i i i i i i i i I-I2.H3, 1. 1 iPiROiPIUidCSi nft i i I i n i i l i I 

CAiTi ii, iBflU i i i i i i 41 i i i i i i i i i I i i i 

i , i i i i i E OLI i i i i i i i40i i i i I i i i i i i i i 

r»iC AT*M., ,PftODy,CgSi AZ4fl lin inn 
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11.0.1.1.5 / (Arithmetic Quotient). This operator divides the- value on the left 
by the value on the right. Any remainder resulting from division is ignored. 

Example 



i i i i i i i i i l+A/A i 


., .PftOlDMAfijS, , ,3i i h i i i i 


Mill 


l i i i I i l l i KJi/Sl i 


•i iPiRiOipMde^, i A i I i 1 1 i i 


1 1 1 1 


i i iii i iii hili4/ 2 i 


.•i iPRIODMCeS, n7i I i . i i . 


MM 


A^f A iimi fiQH i 


1 i i i 1 AP\9fa i i i i 1 i ii i i 


MM 


IiTfHi Mini iFiftUi i 


I 1 1 I 1 |S,I |2.| Mill Mill 


11 11 


i i i4AiR£Ai/iHTifiMi . , 


., ,p,RO|OW,CfiSi ,0,10, inn 


Mill 



11 - 8 - 1 - 1 - 6 // (Covered Quotient). The covered quotient operator divides the 
value on the left by the value on the right, and adds +1 to the resulting 
quotient if the division resulted in a non-zero remainder. 



Example 



i i rt|6i//i2| | | 




i 3i ii i 


1 i i i i i ii i i 1 


i i i+i"7i/|/|3| i 


i ,. . .PiRAOAJiCIES, 


i 3i i i i 


1 I 1 1 1 II M 1 



11.8.1.1.7 +. (Arithmetic Sum) This operator adds the value on the left to the 
value on the right. 

11.8.1.1.8 - (Arithmetic Difference) This operator subtracts the value on the 
right from the value on the left. 

Example 



i i i i+ifci*i4 i 


i ,.| ,P|R|O|0|U|C|e,S| |0|I|2| i M 1 i ii i i i i i i 1 


i i i r^rA i 


i i*i |P|R|0|D|U|C|E|S| i i2i i i i i i i i i i i i u 


, | | |4^7|4Pf7 


rii li ,pftowjiCie,s, ,0,10,6, 1 1 1 1 1 1 , 1 1 1 1 1 


i i i r+A+^i i« 


iPlRODMEiSi ,AI VA1L1U1& iEAUUU.1 iTiOi i i u 


, ,., ,T,H£ XiOINT^WiTA «F. lT,H,f, fiVM&ft , , i i , m ■ 


, ,., AfiPAESIS, .CPUNXEft i+, 3, ,,,,,, i ,,,,,,,, , 
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11.8.1.2 Logical Operators 

This class of operator includes the logical product (**)', logical sum (++) , and 
logical difference ( — ). 

11.8.1.2.1 *» (Logical Product). The logical product operator forms the bit- 
by-bit product (AND function) of the two values to the right and left of the 
operator; for example, if (and only if) the two values both have a 1 in the 
same bit position, the result contains a 1 in that bit position. 

Example 

l +A3,7,4« l »AfckUi , , ,., ,P*OlDU£gS, 014,01 I 

,+.&4i»i»,33, ■ 1 . i . . ■ ■*■ RROfcUJCfiS, 0-46 I I 

11.8.1.2.2 -H- (Logical Sum) The logical sum (INCLUSIVE OR function) sets a 1 
in each bit position of the result if either or both of the values preceding 
and following the operator have a 1 in the corresponding bit position. 

Example 





, ,., ,PAODUC*A' 


lOilffiH , , , i , i , , , 1 


, l «A4aQ*rtiSlS. , i 


i ,«, PRODUCES, 


i0443l i i i i i i i i i 



11.8.1.2.3 -- (Logical Difference). The logical difference operator (EXCLUSIVE 
OR function) sets each bit of the result to a 1 if either, but not both, of the 
two values on the right and left sides of the operator has the corresponding bit 
set . 

Example 



i i+i4-h3i i i 1 




i i i i 1 i 


1 1 1 1 1 II 1 1 


i rh4rn"7| i i 


, 1*1 ,PftO|QU£|E|S| , 


l3l MM 1 


1 1 1 1 1 1 1 1 



11.8.1.3 Conditional Operators 

This class of operator always produces a resultant value of 1 or 0, depending on 
whether or not the condition expressed by the particular operator is satisfied. 



11-11-68 



Mr5035 

Change 2 



11.0.1.3.1 - (Equal). The equal operator results in a binary value of 1 if the 
value on the left is equal to the value on the right; and a value of if the 
two values are not equal. 

Example 

i , ■ . ..I PiRADMCfrS, |A VAiLiUEi iQFl .1 iI.F. mil 

A iHiAIS, iSflMfiiVWfiRiC, &£GH ,0^11^03, AS, , ■ I 

i i i i»i BiEiXMIGi 1E1Q1U1&1L1 iTiOI li 1 i i i i 

. i l 4,A l ^aM.(i6l g 3i) i i • i iftRiQQlUiCiESi CkAA i I I 

... iIP ft MAISi 1B1E1EN1 iDiEiFIIMiEDi MJ,TiHi IA. HALVR , , I 
... Of. a,., OfTiHiEiRiWiliSiE^ I ITHfi .RfiSOim JiS iZfiRA i I 

11.0.1.3.2 > (Greater Than). The greater than operator results in a value of 1 
if the quantity on the left is strictly greater than the quantity on the right; 
otherwise, the resultant value is 0. 

Example 





i i £iQM i i I3i i i i i i i i i 


i i i i i i i i i 1 i 


II 1 1 1 1 1 1 1 


A 


i i iEQiU i i I2i*Bi i i i i i i 


i i i i i i i i i i i i i i i i i i i 


i i *Ai>ft i . • i ,P.fiaOU,C£S 


i il i i i i i i i i i i i i i i i i 


_].. 


i i i iii i i U i JfiMi TiH.IiS 


EXAMiPLiEi i i i 


1 1 II 1 1 1 1 


1 


i f*iSi+ifiB|XiTl-7,l,^iM iPRAftUlCiEiSi i04i i i i 1 i 


1 1 1 1 1 1 1 1 


I 


i ... ilf. flillT, iHA,S, .BAEiKti 0£iFiXMfiO >AIS> 




1 


i ... 6iR£AiTI£iRi iTWAWi ,^,11 


.. 0,T,H£fcWI,S£, 


iTIHiEi nil 


1 


i i'i SiXPRBStt&U PRODUC£iS , & M 1 i 


! 1 M 1 1 II 



11.8.1.3.3 < (Less Than). The less than operator compares the value on the left 

with the value on the right and sets the result equal to a 1 if the left-hand 

quantity is less than the quantity on the right; if it is not less, the result- 
ant value is 0. 
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, rMi^.li i», iPlgQDiUC£S i 11 JK A i i i . 1 , . . . . . . , . I 

, ,IS iLfiaS, .THAR .7, AMD 2£R0, XF1 , , ■ , , , , , , I 
■ • A XA .EtaAJAL, ,T0, 0R1 fi,REA,T£R TIM, AN, ,7, , , , , I 
, All. .PRODUCES Q4.4, X.F, I , 

, . i , , , , i i 1 i i*. ,B, IS, iLlESiS. TMAH ,4., Xfr .MiQT r . 

i i i I i i i i i l»i TiHgi iRiEiSUILTi X,S, iZ£RD\ , . . i i , . i . 

11.8.2 Operator Priorities 

In the absence of parentheses, individual operator priorities determine the 
order in which elements are combined within an expression. Evaluation is 
performed left to right if two or more operators with the same priority occur 
within the same expression. 

Table 11-2 shows that *+ , and */ have the highest priority (6), and -,>, 
and < the lowest (1). Thus, within a given expression, elements separated by 
one of the three exponential operators are combined before any one operation 
is performed. Comparison of values within an expression is done last (such as 
is done when any one of the three conditional operators is encountered). 

Example 



. .-Mift*2n2i4|/(M.M3i i 


. 1 i il i i . . i i 1 


i > i . i . i i i 1 


im WW* i»i |P,RPPMiC l e l s, 


,01 Ail i i i i i I i 1 


1 1 ! 1 1 1 1 1 1 


i-i WTfi iTjHIArT ,L^,Mfi ,1 


, iXS, .6QUI,V,ALI6|4,T, i . . i . > 1 


i*i iT,0. : , i rf.fll,8*2.>ri(,(i2 


.4L/to»}i*i2,),+A3i 1 


1 1 II II Mil 


A i iEAiU i i i 1 iSi mum 


ill i i i I i i i I 1 


1 1 I 1 1 i 1 1 1 


i rrtAmVdf* 1*1*4**7, , i 


i hi A i i ii i i 


1 II 1 1 1 1 1 1 1 


,., jLjXjMtf ,2, IPfiOftUtjEft 


iWPi i i m i i 


1 1 1 1 1 1 1 1 1 1 


, . .-A.*a/,3.*lfef*A^7. , , 


i. hi ft i n i i i 


1 1 II 1 1 1 1 1 1 


.-. .LIMB 3, IPR,O.D|J,C,ES, 


i III i i i i i i i i 


1 1 1 1 1 1 1 1 1 1 




I h i Ai i I L I 1 l 


1 II 1 MM 1 


,-. ,(.I,N£ 4 IRROOAJCfiS. 


i-IOfci4 , ..Mil 


1 1 1 1 1 1 1 1 1 1 


.-. AiMiD. IS, IEftUXVAL.EM.TI X,0, ,LIM,6, ,51 


lftfiLp,W, , , , 


i i ^\(\^&\(^\3i)r^h^C3&\6\^\0i7\7\)\ \ i i i h 


iSi i i i i i i i 
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11.8.3 Parenthetical Grouping 

The normal sequence of evaluation within an expression may be altered by using 
parenthetical grouping; that is, enclosing certain portions of the expression 
within parentheses to override the normal rules of evaluation. The effect is 
to evaluate that portion of the expression within the parentheses as though it 
were the only expression on the line, independent of any elements or operators 
occurring outside of the parentheses. The value resulting from this evaluation 
is then substituted as an element in the entire expression, and the evaluation 
is continued. 

Up to five levels of parenthetical grouping are allowed. When encountered, the 
expression within the innermost set of parentheses is evaluated first. 

11.8.4 Relocatability 

The final value resulting from the evaluation of an expression may be a memory 
address reference and, as such, may be potentially relocatable; for example, 
the memory address may be modified at load time. General rules which govern 
whether the result of an expression shall be relocatable or not are: 

a. A floating point value is never relocatable. 

b. The value resulting from a logical or conditional operation is not 
relocatable . 

c. Only the + and - arithmetic operators yield a result that is 
relocatable. The one exception to this rule is multiplication 
or division of a relocatable quantity by +1. 

Tables 11-3 and 11-4 summarize these rules for reloctability.. 
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TABLE 11-3. RELOCATION OF BINARY ITEMS 



First Item 


Operator 


Second Item 


Result 


Binary or floating 


.< . =■, > 


Binary or floating 


Not relocatable 


Ri narv nr flnfltinn 
uj.ua ij kj 1 xj.uauj.iiy 


» t 


oinary or iioating 


Not relocatable 


Not TP 1 or a t ah 1 a 


+ ■ 


inoi reiocatapie 


Not relocatable 


Rpl npa t ahl o 
iiciui/d LdJJic 

(binary) 




Not relocatable 
(binary) 


Relocatable 


Not relocatable 
(binary) 




Relocatable 
(binary) 


Rp 1 or a t ah 1 p 


Relocatable 




Relocatable 


Not relocatable 


Binary or floating 


/. 


Binary or floating 


Not relocatable 


Binary or floating 


*/■ 


Binary 


Not relocatable 



Multiplication or division of a relocatable item by +1 results in a 
reloctable value. 



TABLE 1 1.-4. SINGLE AND DOUBLE PRECISION EXPRESSIONS 



First Item 


Operator 


Second 


Item 


Result 


Single 


< . =. > 


Single or 


double 


Single 


Double 




Single or 


double 


Single 


Single 


ft, ++,- -A 


Single 




Single 


Single 


*, /, //' 


Double 




Double 


Double 




Single 




Double 


Double 




Double 




Double 


Single 


*+ *_ 
t 


Single 




Double 


Single 




Double 




Double 


Double 




Single 




Double 


Double 




Double 




Double 


Single 


. */ 


Single 




Single 


Single 




Double 




Double 


Double 




Single 




Double 


Double 




Double 




Double 
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11.9 ASSEMBLER OUTPUTS 

The Assembler produces only relocatable object output. The location of* the ob- 
ject program then becomes a load-time determination. Assembler object code 
format is described in Volume I, Section 3 as part of the inputs to the Object 
Code Loader. 

Along with the relocatable object code, the Assembler passes to the Loader the 
number of errors that occurred during the assembly (see Volume 1, paragraph 
2.2.3 for loading). The number passed to the Loader does not include the num- 
ber of T errors or R errors (see paragraphs 11.9.2.5 and 11.9.2.6). 
Concurrent with the source language translation and output of the loadable 
machine code, the Assembler produces a side-by-side assembled program hardcopy 
listing. 

11.9.1 Side-By-Side Listing 

This side-by-side listing contains: 1) a sequential decimal source language 
statement number; 2) each source language statement together with any generated 
addresses; 3) object code resulting from translation of the statement; 4) As- 
sembler-detected translation errors and warnings included along with the state- 
ment in error. By means of Assembler directives, the programmer can suppress 
all or any part of the side-by-side listing. Another Assembler directive per- 
mits the programmer to control the editing of the generated machine code into 
logically discrete fields. 

11.9.2 Error Codes 

11.9.2.1 Expression (E) 

Expression errors result from illogical expressions such as a decimal digit 
within an octal number; element type inconsistent with arithmetic operators; 
expression improper in context , such as a GO line used outside a macro or a DO 
count in excess of 2^-1, or unequal number of left and right parentheses. 

11.9.2.2 Duplicate (D) 

Duplicate errors result from labels defined more than once with different 
values. A label used in an expression affecting an address counter is not 
defined prior to its use resulting in a different addressing sequence in the 
first and second assembly passes. 
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11.9.2.3 Undefined (U) 

An undefined error results from any of the following three conditions: 

1. A reference made to a label which was not defined in the program. 

2. A reference made to a label that was not externalized properly 
by a call on a macro. 

3. A failure to suffix labels of macro entry points with an adequate 
number of asterisks. 

11.9.2.4 Instruction(I) 

An Instruction error results when the Assembler encounters: 

a. A MACRO or EQU directive which has no label. 

b. A SEGEND within a MACRO. 

c. More than one coded subfield in field zero of a MACRO reference 
line called via a MACRO name. 

d. A nested LIB directive or a LIB directive within a MACRO. 

e. A LIBS directive retrieved from a library. 

11.9.2.5 Relocation (R) 

A Relocation error results from an arithmetic or logical operation being per- 
formed on a reloctable value which destroyed its reloctability. 

11.9.2.6 Truncation (T) 

A Truncation error occurs when the final value of an expression does not fit in 
the destined bit field of an object word, resulting in the Assembler truncating 
the left -most bits of the value in order to make it fit the field. 

11.9.2.7 Overflow (0) 

The Overflow error occurs when memory available for the Assembler tables is 
exhausted. 

11.9.2.8 Name (N) 

A Name error occurs when the Assembler encounters a name which contains more 
than eight characters. 
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11.9.2.9 Level (L) 

A Level error results from an expression containing a parentheses nested more 
than five levels or from more than 64 SETADR lines appearing in this assembly 
or from an incomplete MACRO definition retrieved from a library. 

11.9.2.10 Floating Point (F) 

A Floating Point error occurs under any of three circumstances: 

1. The divisor in a requested floating point divide operation is 
zero. 

2. A floating point operation during evaluation of an expression 
yielded characteristic underflow. Characteristic underflow 
occurs whenever the characteristic is less than -32767. 

3.. A floating point operation during evaluation of an expression 
resulted in characteristic overflow. Characteristic overflow 
occurs whenever the characteristic exceeds +32767. 

11.9.2.11 Warning (W) 

A warning results when a label is used with a half-word instruction which is assigned 
to the lower half of a computer word. 

11. 9.3 Generation Formats 

Assuming the editing listing option has been selected, a number of generated words, 
values, or half-words appear. They are: 

S FIELD CODED EXPLICITLY. - 
000120 14 00265 AA AO, CLASIV, , , SO 

S FIELD NOT CODED (SY COMBINED). - 
000205 52 000211 LBJ B7, FETCH 

FULL-WORD (ON-LINE CONSTANTS OF EQU VALUES). - 

001140 37700000377 

00000000001 Al EQU 1 
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HALF-WORD INSTRUCTIONS. - 



000123 71 2 
000123 61 11 1 



HAN 
HLCI 



AO, AO 
010+B1,A0 



11.9.4 Listing Of Labels 

The Assembler provides programmers via the LLT directive, with an al phanumerical lj 
sorted listing of source statement labels and corresponding Assembler-generated 
addresses or values. Listed labels are those defined at levels and 1. LLT 
labels do not include MACRO, NAME, FORM, and LIT line labels. 

11.9.4.1 Level 

Level labels are those names which are made available to another program at 
load time to some other independently processed code. 

1 1. 9.-1.2 Level 1 

Level 1 labels are those names encountered on the main program level. 
11.9.4.3 LLT Sample Listing 

A sample of the listing produced by the Assembler after processing a LLT 
directive appears below: 

* LIST LABEL TABLE * 



AO 
A3 
Bl 
B4 
B7 

BEGIN1 



ADO 

BWAIT 

CBUFF 



00000000000 Al 

00000000003 A4 

00000000001 B2 

00000000004 B5 
00000000007 BCOUMT 
0000062 00 BUFF 



0000353 00 AGAIN1 
0000347 00 BWAITO 
0000544 00 CDIV 



LEVEL 

00000000001 
00000000004 
00000000002 
00000000005 
00000000002 
0000150 00 

LEVEL 1 



0000275 
0000262 
0000521 



00 
00 
00 



A2 
A7 
B3 
B6 
BEG 

BUFFLAG 



AGAIN2 
BWAIT2 
CHARCK 



00000000002 
00000000007 
00000000003 
00000000006 
00000000007 
0000125 00 



0000402 00 
0000355 00 
0000444 00 



11.9.4.4 Undefined Labels 

Names or symbols encountered during the assembly which are not defined are 
listed: 



UNDEFINED SYMBOLS 



PRDIR 
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11.9.4.5 Cross Reference Listing 

A cross reference listing can be produced at the end of an assembly if an LCR 
directive has been previously encountered by the Assembler. This listing con- 
sists of labels, address counter values, and address counters where these labels 
are referenced. A sample listing is shown in figure 11-5. 

11.10 ASSEMBLER DIAGNOSTICS AND STATUS 

Several categories of errors encountered during the assembly process cause an 
error message to be output to the standard hardcopy device, These errors fall 
into one of four classes: 1) Assembly; 2) Assembler Internal; 3) Library 
call; and 4) Peripheral. 

1 1 . 10 . 1 Assembly Errors 

If an assembly error occurs during the assembly process, the following status 
messages will appear on the standard hardcopy devices: 

ASSEMBLY ERRORS 
XX YY 
XX YY 

Explanation 

XX Any one of the following: 






Overflow 


u 


Undefined 


D 


Duplicate 


E 


Expression 


T 


Truncation 


R 


Relocation 


I 


Instruction 


L 


Level 


N 


Name 


F 


Floating-Point 



YY The number of errors of type XX that occurred in the assembly. 
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LIST CROSS REFERENCE TABLE 



LI 


000005 


00 


LI 


OOOOOil 


Ll 


Ll 


LI 


ouuom 


00 


L2 


000006 





L2 


L? 


OOO001 


07 


L2 


000001 


15 


L2 


L3 


000002 


05 


L3 


000002 


f'7 


L3 


L«* 


000012 


00 


LU 


000002 


01 


L<t 


L«» 


000017 


00 


L5 


000013 


no 


Lb 


L5 


000004 


15 


L5 


"00020 


(tO 



03 cn 
3 o 

tQ CO 

to 



JOOOOO 


u5 


Ll 


OU00OU 


07 


Ll 


oooooo 


15 


UU0007 





L2 


000000 


01 


L2 


000001 


05 


000015 


LO 


L3 


UU001U 


00 


L3 


000001 


01 


U00002 


15 


L3 


UU0016 


00 


L4 


000011 


00 


UU0003 


05 


L» 


000003 


07 


L4 


000003 


15 


U00003 


01 


L5 


0U00U4 


05 


L5 


000004 


07 



Figure 11-5. 



Sample Cross -Reference Listing 



M-5035 

Change 2 



ILLOGICAL SOURCE INPUT SEQUENCE 

This message occurs when the Assembler has read a sentinel statement. This only 
occurs when an illogical sequence of source cards is input to the Assembler. 

NOT ENOUGH UNAS SIGNED TAPES 

The Assembler is unable to obtain enough tapes to assemble with the requested 
output options. 

11.10.2 Assembler Internal Errors 

11.10.2.1 Core Overflow 

The core overflow error occurs when the Assembler item table macro sample 

storage area, memory intermediate storage area, or literal origin stack overflows. 

No recovery is possible. 

11.10.2.2 Level Overflow 

The level overflow error occurs when the number of nested macros exceeds 29. 
No recovery is possible. 

11.10.3 Library Call Errors 

The following message is typed if the Assembler is unable to locate a called 
source library element on the assigned library medium: 

**** LIB REF ERROR S name (vers) 

Explanation 

S Denotes source library. 

Name (vers) The called library element name (version). 

After che typeout, the Assembler continues without soliciting a response from 
the operator. 

11.10.4 Peripheral Errors 

The following peripheral error indications are received by the Assembler from 
the Centralized I/O Program or the Standard Input Program, and no recovery 
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is possible (the MN field in the messages is the name of the device involved 
in the error): 

I/O ERR MN END OF FILE 

A tape mark has been read while reading from the input. 

I/O ERR MN UNREC ERR 

A tape error has occurred and recovery procedure was unsuccessful. The tape 
function was retried five times without success. 

I/O ERR MN ILLEG PROC 

An illogical function has been requested (such as a magnetic tape read forward 
when the tape is positioned at the end of tape, or a pass backward function 
while the tape is positioned at the beginning of tape). 

I/O ERR MN STRG END 

End Of tape was detected during a magnetic tape function or while using core 
memory as intermediate storage, or there was not enough core memory available 
to store the source program. In the second case, MN in the message will be 
MM. 

I/O ERR MN NOT ASSIGNED 

An I/O function was requested on a logical unit which had been removed from 
the current equipment configuration. 

11.11 SOURCE DECK ORGANIZATION 

Figures 11-6 through 11-10 illustrate example structures of source decks. 




Figure 11-6. Source Deck Organization for a Single Program 
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^*OFF 
END 




Figure 11-7. Source Deck Organization for Assembling Using 
Library Input. 
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♦OFF 



END 

SEMBLER SOURCE 

ck second segmen: 



f ♦ ULTRA 
/ SEGEND 



ASSEMBLER SOURCE 
DECK FIRST SEGME 



ZE / 



L 



♦ULTRA 



$ASM 



J This card indicates 
I dependent programs 
^or segments. 



Figure 11-8. Source Deck Organization for Two or More Dependent 
Programs or Segments 




This card indicates 
independent programs 
or segments. 



Figure 11-9. Source Deck Organization for Two or More Independent 
Programs or Segments 
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Figure 11-10. Source Deck Assembly Time Allocation 



11.12 SPECIAL CONSIDERATIONS 

a. Only the first *ULTRA Assembler control statement has any effect on 
the mode of intermediate storage or on the name recorded 

on the object code program ID images. Subsequent *ULTRA statements 
are passed over by the Assembler. 

b. When coding for the CMS-2 Assembler, it is desirable to keep label 
lines (lines containing only a label) separate from coded machine 
instructions. This allows shifting the label line without altering 
any other line(s) . 

c. If a number of successive half-word (16-bit) instructions are 
encountered (under the same address counter) by the Assembler, they 
are packed two per word. The first half-word encountered after 

the address counter has been activated/reactivated is packed into 
the upper half of the generated word. 



11-11-83 



M-5035 
Change 5 

d. Generation of half-word in-line constants or literals is always in the lower 
half of the word with no packing. 

e. If LLT and LCR directives have been encountered and no reference is made 
to a relocatable label within the assembly, the label will be flagged with NR. 

f. The assembler call $ASM,U indicates the ULTRA/32 keypunch code is to be 
used when interpreting source statements for the assembly. If the U is not 
present, the keypunch code specified in the $JOB command is in effect. 
Note: ULTRA/32 keypunch code is not interchangeable with the 026/029 
keypunch codes. See special character codes for options in Appendix A. 
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SECTION 12 
INSTRUCTION REPERTOIRE 
12.1 AN/UYK-7 COMPUTER FUNCTIONS 

The UYK-7 is a general purpose, multi-state, mul ti -processor , multi-l/O 
processor, stored-program computer. Some of the features of this computer 
relevant to a programmer are: 

a) High-speed memory with a cycle time of 1.5 microseconds and a capacity of 
16,384 words expandable with more memory banks' to 262,144 words. 

b) Memory banks containing 16,384 words each that can be addressed by the 
arithmetic processorC s) , the I/O processor(s) , and external devices with 
proper hardware adaptation. 

' c) A portion of memory is non-destructive readout (NDRO) for storage of 

critical instructions and constants. This storage provides the facility 
for automatic recovery in case of a system failure or program fault and 
for automatic initial loading of programs. 

d) A 32-bit word length allowing for storage of one full-word instruction or 
two packed half-word instructions. 

e) Ability to address a 32-bit whole-word, 16-bit half-word, or 8-bit quarter- 
word with no difference in execution time. 

f) Use of parallel, one's complement, subtractive arithmetic. 

g) Use of single address instructions with the provision for address modifi- 
cation via seven index registers and eight base registers. 

h) Floating point and double prevision fixed point arithmetic functions. 

i) Memory protection, in segments of up to 65,536 words, under both program 
and manual control. 

j) An indirect addressing capability. 

k) Any field of a word addressing capability. 

1) Provision for connecting a remote operating console. 
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m) A manual/program addressable breakpoint register which may be set to stop 
or interrupt program operation at any point. 

n) Interrupt and task states each with their own associated registers. 

o) A status register which contains information concerning the current status 
of a processor. 

p) Interrupt status or definition code capability. 

q) Provision for half-word instructions. 

r) Privileged instructions which can only be executed in the interrupt state. 

s) Eight arithmetic accumulators provided to allow parallel and cumulative 
computation. 

t) A processor capable of retrieving the current operand and the next 
instruction in parallel if located in different memory banks. 

u) Five different types of instruction formats. 

v) A processor decremental monitor clock, an IOC incremental realtime clock, 
and an IOC decremental monitor clock. 

12.1.1 Register Format and Usage 

12.1.1.1 Program Address Register 

The program address register (P) holds the address of instructions to be 
executed by the computer. This register holds 19 useable bits. Bits 19 
through 17 (P<J hold a base register designator, through 7, while bits 15 
through (Pp) contain a displacement value, relative to the address contained 
in the designated base register. Bit 16 is not used. 



I9|lt|'l7 


It 


.s|.<| i3 m,,m.|>I'I«m<I>U|i|° 


p s 







P Register Format 
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12.1.1.2 Addressable Registers, Control Memory 

Table 12-1 gives the control memory address assignments for the central 
processor. 

Accumulator register format 

St |$0|»>|M|»7|a>|t9|84|»a|l2|2l |2Q|t»| l»| IT| l*| IS 1 t4| |»| I2| 1 1 1 IO| 9 \ t \ 7 | % \ i | 4 | i \ 2 | I \ 

A 



Base register format 

.7|»|l»l l 4|.»| l a|..1.0|M»l7|>|»|4is|2l.|0 

s 



Index register format 







.S|.4|.3|.2|..|.0|«|t|7|6| 9 |4|3|2|>|0 






B D ~ 



Where: 

Bg = base register designator. 
B D = displacement value. 

When actually used for indexing, only the 16 bits of B Q are used. Bit 
16 is not used. 



II-12-3 



M-5035 



TABLE 12-1. CENTRAL PROCESSOR CONTROL MEMORY ADDRESS ASSIGNMENTS 



CMR Address Register Selected Register Size 



0-7* 


Task Accumulators (Registers 0-7) 


32 


bits 


each 




Unassigned (Addressable) 


19 


bits 




11-1 1 


lask index (.Registers 1- < ) 


19 


bits 


each 


Of! T7* 


Task Base (Register 0-7, Addressable 
in Interrupt Mode Only) 


18 


bits 


each 


30-57* 


Unassigned (Not Useable) 








6X** 
7X** 


Breakpoint 

I (Addressable in Inter- 
r rupt Mode Only) 
Active Status*/ 


20 
23 


bits 
bits 




100-107** 


Interrupt Accumulators (Registers 0-7) 


32 


bits 




110** 


Central Processor Monitor Clock 


19 bits 
only 16 


(clock 
bits) 


111-117** 


Interrupt Index (Registers 1-7) 


19 


bits 


each 


120-127** 


Interrupt Base (Registers 0-7) 


18 


bits 


each 


130-137** 


Unassigned (Not Useable) 








140-157** 


DSW snd ICW 


20 


bits 


each 


160-167** 


Storage Protection Registers 
(Registers 0-7) 


21 


bits 


each 


170-177** 


Segment Identification Registers 
(Registers 0-7) 


21 


bits 


each 



* Task mode CMR address. 
** Interrupt mode CMR address. 
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Breakpoint register format 



It 


it 














B 


I 




B 










BPj = when set, compares BP^ with instruction memory address. 
BPq = when set, compares BP^ with operand memory address. 
If both BP Q and BPj are set, both operations are performed. 
BP A = an absolute address, up to 18 bits. 

Central processor monitor clock register (CPMCR) 



I»|lt|l7 


i« 


I9|l«|l3|l2|ll|l0|» | • | 7 | 6 | 5 | 4| S| 2 | 1 |0 


Not 
Used 




CPMCR 



The CPMCR, when activated, is decremented at the rate of 1024 counts per 
second. A class II interrupt is generated when its value changes from zero 
to a negative value by hardware decrementation. If bit 15 is set, the clock 
is deactivated. 

Initial condition word register (ICW ) 



I*|lt|l7 


l« 


I3|l4|lj|l2|ll|l0|» | • | 7 |« | 5 | 4| 3| 2 | 1 |0 


icw s 




icw D 



The four ICW registers contain entrance addresses for the four interrupt 
classes. ICW g contains a base register designator and bits 15 through 
(ICW. ) contain a displacement value. 
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Designator storage word registers (DSW) 





16 


, 5 |l4|,3|l2|M|lO| 9 ]9|7|6| 5 |4| 3| 2 |l |0 


Dp s 




DP D 



DSW (P Register) 



I«|ll|l7|l>}is|l4jl»|l2|lljl0|»|>|7 |« | 8 | 4 | 3 | 2 | I \0 



DSW 



ASR 



DSW (Active Status Register) 



I»|l«|l7ll«|l9|l4|l3|l2|ll|l0|9|«|7 |6j5|4| 3 | 2 | I |0 



DSW 



ISC 



DSW (Interrupt Status Code) 

The twelve DSW registers are in sets of three; each set is used for one 
of the four interrupt classes. During an interrupt sequence, Pg of the P 
register is stored in DP<, t and P Q of the P register is stored in DP D< Bits 
19 through of the Active Status Register are stored in °SW^g Rf while the 
Interrupt Status Code is stored in DSW^^. 

Storage protection registers (SPR) 



20 j l9 | l> l l7[n|ia|l4|l3|l2|ll|l0|9|e|7 |el»|4| 3 I 2 I I |"o 



IR 



IA 



ow 



OR 
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The eight SPR registers correspond to the eight task base registers. R is 
a displacement value, defining a segment of memory with a starting address 
contained in the corresponding task base register. A final address is this 
address plus the value in R. This segment is then the only memory area 
accessible by the corresponding base register. The allowable types of 
operations within such a segment are defined by bits 20 through 16. The 
following operation is allowed when these bits are set: 

Bit 16 (IR) - Use of interrupt index and base registers in indirect 
addressing. 

Bit 17 (IA) - Use of indirect addressing. 

Bit 18 (OW) - Operand writing. 

Bit 19 (OR) - Operand reading. 

Bit 20 (I) - Instruction execution. 

The SPR s are loaded by executing the LOAD BASE and MEMORY PROTECTION 
instruction (05 4). The lower 21 bits of the contents of the operand address 
+1 are loaded into an SPR. 

Segment identification registers (SIR) 



20 


lt|lt|lf 


I« 


I9|l4|is|l2|ll|l0|9 | • | 7 |* | 9 |4 | 3| 2 | 1 |0 




SI*. 




SIR D 



The eight SIR registers correspond to the eight task base registers. 

SIRg : base register designator. 
SIRp : a displacement value. 

These registers are loaded with the effective operand address of the LOAD BASE 
and MEMORY PROTECTION instruction (05 4) which loads the corresponding base 
register . 

s field ^SIR g ; y + CB b ) 15 _ Q - SIR D 



II-12-7 



M-5035 
Change 3 



12.1.2 Modes of Operation 

The AN/UYK-7 Computer can be operated in one of two modes of operation: 
1) the executive (or interrupt) state or 2) the task state. Both states can 
be manually or program initiated. Four bits of the active status register 
specify the state the computer is in according to Table 12-2. 





TABLE 


12-2. 


AN/UYK-7 COMPUTER MODES OF OPERATION 


Active 


Status 


Register Bits 


Processor State 


2 19 


2 18 












2 17 


2 16 
















Task state 











1 


Executive state 








1 





Interrupt class III state 





1 








Interrupt class II state 


1 











Interrupt class I state 



12.1.2.1 Interrupt State 

In the interrupt state, the computer has the following characteristics: 

a) The computer can reference any memory word which has been locked out. 

b) The computer uses the interrupt set of accumulators, index registers, 
and base registers. 

c) The computer can come to a stop condition. 

12. 1.2.2 Task State 

In the task state, the computer has the following characteristics: 

a) The computer can reference any memory word which has not been locked out. 

b) The computer uses the task set of accumulators, index registers, and base 
registers. 
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c) The interrupt state set of registers cannot be referenced. 
<j) Privileged instructions will not be executed. 

e) The task set of base registers can be modified only under certain conditions. 
12.1.2.3 Active Status Register 

The active status register (see Table 12-3) is a 23-bit register (one for each 
processor) showing the current environment relative to that processor at any 
moment . 

TABLE 12-3. ACTIVE STATUS REGISTER 
Bit Number Designator 



CP identifier 

State I «\ Under 

State II L Hardware - see Table 3-2 

State HIT Control 

State IV^ 

Upper/ lower 

Class I lockout 

Class II lockout 

Class III lockout 

Base(s) register selector 

Accumulator and index register selector 

Memory lockout inhibit 

Load base enable 

Bootstrap mode 

Not allocated 

Fixed point overflow indicator 

Compare 
designators 
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Upper/lower control - bit, 15 

The upper/ lower control bit is set when an upper half-word instruction 
has completed execution and is cleared when a whole word or a lower 
half-word instruction has completed execution. 

Class I lockout - bit 14 

Locks out class I interrupts when set. 
Class II lockout - bit 13 

Locks out class II interrupts when set. 
Class III lockout - bit 12 

Locks out class III interrupts when set. 

Accumulator/index register selector - bit 10 

This selector is set in the interrupt mode and cleared in the task mode 
to select which set of A and B registers the active program may access. 

Special base register selector - bit 11 

This selector is set when entering the interrupt mode and cleared in the 
task mode to select which set of base registers the active program may 
access . 

Memory lockout inhibit - bit 9 

The 1-bit memory lockout inhibit (bit 9) is set (inhibit mode) in the 
interrupt mode and cleared (memory lockouts used) in the task state. 

Load base enable - bit 8 

Allows use of Load Base and Memory Protection instructions in task state 
when set. 

Bootstrap mode - bit 7 

Set manually to enable access to NDRO memory during bootstrap load. This 
bit is cleared under program control by execution of the following 
instructions: Interrupt Return, or Enter Executive State. 
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Spare bits - bits 4-6 

Bits 4 through 6 are programmable spare bits. 

Fixed point overflow indicator - bit 3 

Displays the status of fixed point overflow (is set if overflow occurred). 
This bit is tested and cleared under program control by execution of the 
following instructions: Jump on Overflow, and Jump on No Overflow. 

Compare designator - bits 0-2 

The compare designator (bits 2,1, 0) display the status of the compare 
instructions as specified in the descriptions of individual instructions. 
The status word designation is as follows: 

a) Bit 2=0 unequal case 

= 1 equal case 

b) Bit 1 = less than 

=1 greater than 

c) Bit 0=0 within limits 

=1 outside limits 
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12.2 AN/UYK-7 INSTRUCTION FORMATS 

There are five different types of instruction formats: three are full -word 
formats and two are half-word formats. Half-word instructions do not have any 
memory reference parts because these instructions deal mainly with data 
manipulations between various registers. 

The AN/UYK-7 Computer is a self-modifying, one-address computer. Although one 
reference or address is provided for the execution of an instruction, this 
reference or address can be modified automatically during a programmed sequence. 
The references are modified by using the index registers and the base registers 
which contain previously stored constants. The final operand address is the 
result of adding together the 18-bit content of the selected base register 
plus the 16-bit content of the selected index register, and the 13 bits of the 
immediate operand field of the instruction. 

An instruction or data address is coded using octal notation with each octal 
digit denoting three binary digits. The instructions are read sequentially 
from memory except after jump instructions or interrupt situations. In 
these cases, the sequential execution of instructions resumes at another loca- 
tion in memory. 

Each of the instructions in thr repertoire is assigned to a format class 
according to the operational characteristics of the instructions. There are 
three full-word (32-bit) formats (Formats I, II, and III) and two half-word 
(16-bit) formats (Formats IV-A and IV-B). The paragraphs which follow specify 
the formats and the type of instructions assigned to each. 

12.2.1 Format I Instructions 

The instructions of format I have the following word format: 



SI l90|2*|28|27|2t 


25(24(23 


22(21(20 


<9|.a|i7 


it 


l»|l«|lS 


.2|..|.0l9|t|7|f| 9 |4|»|2|l[0 


f 


a 


k 


b 


i 


s 


y 
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Those instructions basically require two operands: 1) an arithmetic or index 
register specified by the 3-bit a-field and 2) an operand address y-designator . 
The effective operand address y is formed by adding the content of an index 
register specified by the 3-bit b-field, the 13-bit displacement y-value and 
the content of a base register specified by the 3-bit s-field. The 3-bit 
k-field is used to control operand interpretation (see paragraph 12.3.3). 
The one-bit i-field of the instructions is used to specify indirect addressing. 
The f-f ield (6-bits) is the major function code. There are no subfunction 
codes in this format class. 

There is a group of Format I instructions in which the a- and k-designators are 
interpreted as a combined unit. In these cases, whole-word operands are assign- 
ed and ak specifies either a control memory address or a bit position within a 
computer word. 

12.2.2 Format II Instructions 

Format II instructions have the following format: 



91 |SO|29|2S|Z7|26 


25|24|23 


22|2l|20 


"hi 17 


it 


IS|l4|lS 


.*|..|.0|t|t|7|6|s|4|3|2|.|0 


f 


a 


f 2 


b 


i 


s 


y 



Whole word operands (k = 3) are hardware assumed in Format II instructions. 
Thus, the k-fields are used as a subfunction code labeled f^. The other fields 
of the Format II instructions are used in the same manner as in Format I. 

12.2.3 Format III Instructions 

Format III instructions have the following word format: 



SI |SO|2»|2t|27|2< 


2S|24|23 


22|2I 


20 


I»|li|l7 




IS|l4|l5 


I2|ll|l0|*|t|7 |«|s| 4 l S.| 2 | 1 |6 


f 


a 


f 3 


( 


b 


i 


s 


y 



Again only whole-word operands are specified or assumed in Format III instruc- 
tions. Thus, the k-field is divided into two parts: 1) a 2-bit subfunction 
code labeled f^ and 2) a single bit labeled k for which zero is the only legal 
entry. The other fields of Format III instructions are used in the same manner 
as for Format I. 
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12 .2.4 Format IV-A Instructions 

Format IV-A instructions have the following word format: 





ID ID IE ID (□□□□□□□□□OB 




f 


a 


f 4 


b 


i 




□ □ QC □ 32 Q3 E 33 E E EH G3 □ ID ID D 


f 


a 


f 4 


b 


i 



The instructions of Format IV-A require two registers (index or arithmetic) and 
are used for register-to-register transfers and arithmetic operations. The 3- 
bit a-field and the 3-bit b-field specify one of eight accumulators or eight 
index registers respectively. The 3-bit k-field is used as a subfunction 
code labeled f^. Except as specified in the individual instructions, the 
i-field of the instruction is unused in Format IV-A instructions. 

12.2.5 Format IV-B Instructions 

Format IV-B instructions have the following word format: 



.S|.4|.S|. 2 |,.|.0 






f 


a 


m Shift 
Designator 



f a m shift 
I I Designator 

The Format IV-B instructions use the 7-bit m-field to specify a shift count, 
the 3-bit a-field is used to specify one of the eight accumulators whose data 
is to be shifted for shift instructions. 

The m-field value is interpreted as follows: if the upper bit of the m-field 
is set and bit 5 of the m-field is cleared, the shift count is contained in 
the B-register specified by bits 1 through 3; if the upper two bits of the 
m-field are set, the shift count is given in the A-register specified by bits 
1 through 3. If neither of these cases apply (upper-most bit of m equals zero), 
then the shift count is contained in the lower 6 bits of the m-field (maximum 
shift permitted is 63 places). 
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12.2.6 Indirect Word 



If i « I, the 20 least significant bit positions of an instruction (b, i, s, 
and y fields) are replaced with the 20 least significant bit positions of (Y). 
The 12 higher order bit positions of (Y) are used to specify indirect address- 
ing options. The interpretation of the indirect control word is: 



Sl|SO 


29|2»|t7|2«|25 


24|29|22|2l|20 


i»|it|ir 


i« 


I9||«|IS 


.2|..|.0|t|«|7|«|5|4(s|2|l|0 


C 


W 


P 


b 


i 


S 


y 



Explanation 
c 

c=10 
c=01 2 

c=00 t bit 29=0: 



c=00; bit 29=1: 



Control designator specifying the type of 
addressing that will occur. 

For indirect addressing only. 

For single character addressing. 

For sequential character addressing. 

Indirect addressing where bits 17-19 indicate 
the base register and bits 0-15 the 16-bit dis- 
placement. 

Indirect addressing where bits 17-19 indicate 
the index register and bits 0-15 the 16-bit 
displacement . 

Indirect addressing shall continue as long as i = 1 with indexing capability 
at each cascaded level. When i = t the indirect addressing will terminate 
and the current instruction will be interpreted in the normal manner. 

When i = and c . =. (Olgi l^t the remaining ten positions of the indirect con- 
trol word are interpreted and character addressing will occur. In this case, 
the p- and w-designators are interpreted as follows: 

p - bit position designator which specifies the least significant bit 
position of the variable-length character field. 

w - character length designator which specifies the number of bits of the 
character field based at p. 
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When a character has been read from memory by character addressing, it is 
placed in the appropriate arithmetic register, right -j ustified , and zero-filled. 
If c = ll2» sequential character addressing is specified. The indirect control 
word is updated for subsequent addressing of the next character field and then 
stored back in main memory. 

12.2.7 I/O Commands Formats 

The IOC will read the command from memory and begin its execution upon receipt 
of the command address from the central processor. The I/O format is: 



SI |SO|2«|2«|27|2« 


2S|24 


23|22|2l|20 


I* 


it 






[o 


f 


k 


j 


m 


c 


y 



Explanation 



f 


Function code of the command. 


k 


Partial word designator. 


j 


Channel number (0-15). 


c 


Chain flag. 


m 


Monitor flag. 


y 


Absolute 18-bit address of the operand (buffer 
control words, external function words, etc.). 



The buffer control words specify the limits of the buffer of data for input/out- 
put and the desired mode of transfer (a word at a time, half-word at a time, 
and so forth). Buffer control words are in two formats: normal mode and ESI 
mode. 

12.2.7.1 Normal Mode 
The normal mode format is: 



Final Address 
Compare Bits 
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12.2.7.2 ESI Mode 

The KSI mode format is: 



St|SO|29 


2«]27|2«]29)24|23|22|2l|ZO|lt|lt 


I7|l«|l9|l4|l9|l2|ll|l0|9 (• jr |«|s|4|s(2|l|0 


k 


Final Address 
Compare Bits 


y 



Explanation 

y Initial 10-bit buffer address. 

Final address compare bits Initial buffer address plus the buffer's 

length minus 1 truncated to the required 
number of bits to fit the field. 

k Partial word designator. 

12.3 SYMBOLIC CONVENTIONS 

For symbols, registers, and terms used in the computer instruction descrip- 
tions, see Table 12-14. 

12.3.1 f - Function Code Designator 

The f -designator always occupies the most significant 6 bits of the instruction. 
It specifies or determines the type of instruction to be performed. All un- 
used major function codes are illegal instructions and, if executed in the 
upper half-word, will cause an illegal instruction interrupt. 

12.3.2 a - Arithmetic Code Designator 

The 3-bit a-designator specifies which one of eight A-registers an instruc- 
tion will use or reference. The accumulator designation is as follo/js: 

a) 000 2 - Aq 

b) 00 1 2 - k 

c) 010 2 — A 2 

d) 01 1 2 - A 3 

e) 100 2 - A 4 

f) 101 2 A 5 
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110 2 A 6 
111 2 - A ? 



NOTE 

There are two groups of accumulators. 
One group is associated with the task 
state and the other with the interrupt 
state of computer operation. 



11-12-10 



M-5035 



TABLE 12-4. INSTRUCTION REPERTOIRE SYMBOL DEFINITIONS 



Symbol Definition 



( ) 


Content or the quantity 


( )• 


Complement of the quantity 


II 


Absolute value 




Compare 




x 


Multiply 






Divide 






Minus 




+ 


Plus 






Equal 






Not equal 




> 


Greater than 




> 


Greater than 


or equal 


< 


Less than 






Less than or 


equal 


o 


Logical AND or logical product defined as: 






1 












1 


1 




Inclusive OR 


or logical sum defined as: 






1 







1 




1 


1 1 


© 


Exclusive OR 


or logical difference defined as: 






1 







1 




1 


10 


a 


Instruction field designating an accumulator or 




index register. 


A 

a 


Accumulator designated by the a-field. 


A b 


Accumulator designated by the b-field. 
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TABLE 12-4. INSTRUCTION REPERTOIRE SYMBOL DEFINITIONS (continued) 
Symbol Definition 

af^ Instruction field designating the combined a- and 

f ^-fields use to specify a control memory register. 

ak Instruction field designating the combined a- and 

k-fields used to specify a bit position or a control 
memory register. 

b Instruction field designating an index or accumu- 

lator register. 

B 16-bit index register designated by the a-field. 

a 

B^ 10-bit index register designated by the b-field. 

c Instruction field designating indirect addressing 

word type or the chain flag in input/output control- 
ler commands . 

C Input/output channel. 

CA Capable of indirect word character addressing. 

Cj Input/output channel designated by the j -field. 

CD Hardware compare designator. 

CMR Control memory register. 

DSW Designator storage words. 

e Operand field of the HK pseudo instruction. 

EF External function. 

EI External interrupt. 

f Instruction field designating the major function 
code. 

f^.fg.f^ Instruction fields designating sub-function code, 

i Instruction field designating indirect addressing 

or interrupt control memory addressing. 
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TABLE 12-4. INSTRUCTION REPERTOIRE SYMBOL DEFINITIONS (continued) 



Symbol Definition 

I/O Input/output. 

IOC Input/output controller. 

j Instruction field designating an I/O channel. 

k Instruction field partial word designator. 

kj Instruction field designating the combined k- and j- 

fields used to specify a bit position or control 
memory register in IOC instructions. 

1 Operand subfield of buffer control word pseudo 

instructions. 

m Instruction field designating a shift count or 

monitor Clag in an IOC command. 

n Used as a subscript indicating a bit position; for 



example, (A ) . 

an 

Next instruction. 

Overflow designator. 

indirect word bit position designator. 

Program address register, 20 bits. 

Privileged instruction executable only when the 
processor is in the interrupt (executive) state. 



RPT Capable of being executed in the repeat mode. 

RTC Real-time clock. 

s Instruction field designating a base register. 

SIR Segment identification register. 

SPR Stored protection register. 



NI 
OD 

P 
P 

PI 
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TABLE 12-4. 


INSTRUCTION REPERTOIRE SYMBOL DEFINITIONS (continued) 


Symbo 1 


Definition 


sy 


Instruction field representing s- and y-fields in 




combination. 


U 


U register (program control register). 


w 


Indirect word character length designator. 


y 


Instruction operand field designating an address 




or value. 


Y 


Effective address formed by Y + (B fe ) + (S g ). 


Y 


Effective operand as qualified by k (and/or p and 




w when applicable). 



12.3.3 k - Operand Interpretation Code Designator 

The k-designator determines what part of the word referenced by an instruction 
is to be used. When k i 0, bits 15 through 13 specify a base register. If 

-word, the 16-bit operand will 
specifies a quarter-word, the 
ts. If the k-designator 
11 be used. The general 



the k-designator specifies an upper or lower half 
be sign -extended to 32 bits. If the k-designator 
8-bit quarter-word will be zero extended to 32 bi 
specifies the whole word, the full 32-bit word wi 
interpretation of the k-designator is specified in Tables 12-5, 12-6, and 12-7. 
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TABLES 12-5. GENERAL] OPERAND I NT E RP R ET AT ION (MEMORY TO ARITHMETIC) 



k Designator 



Memory to Arithmetic 



o 


sv+(B ) 


— « 


A 

15-0 


Sign extended 


1 


15-0 


— ♦ 


A 15-0 


Sign extended 




(Y 31-)6 ) 




A 

fl 15-0 


Dign cxicnueu 


3 


( W 


— ♦ 


A 

31-0 




4 


(¥ 7-0 ) 


— ♦ 


A 7-0 


Zeros extended 


5 


(Y 15-8 ) 


— » 


A 

rt 7-0 


Zeros extended 


6 


(Y ) 




A 

M 7-0 


Zeros extended 


7 


(Y ) 
1 31-24 ; 


— ♦ 


A 

rt 7-0 


Zeros extended 



TABLE 12-6. GENERAL OPERAND INTERPRETATION (ARITHMETIC TO MEMORY) 

.i 



k 


Designator 


1 


Arithmetic to Memory 






k 


= 


Not usejd 








k 


= 1 


(A l5-0 ) 


-• Y * Y 

15-0' '31-16 


— ♦ 


Unchanged 


k 


= 2 


(A )i 
^ A 15-0' 


-» Y • Y 

31-16' 15-0 


— ♦ 


Unchanged 


k 


= 3 


(A )l 
lA 31-0 j 


- y 

31-0 






k 


= 4 


( ' A 7-0 ) 


-» Y • Y 

7-0' 31-8 




Unchanged 


k 


= 5 


(A 7-0 ) j 


-» Y * Y 

15-8' 31-16 

Y 

*7-0 


— ♦ 

—4 


Unchanged 
Unchanged 


k 


= 6 


(A 7-0 ) 


Y 23-16 ; Y 31-24 
Y 

15-0 


—* 


Unchanged 
Unchanged 


k 


= 7 


(A 7-0 } ! 


-» Y • Y 

31-24' 23-0 




Unchanged 
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TABLE 12-7. GENERAL OPERAND INTERPRETATION (NORMAL REPLACE INSTRUCTION 
INTERPRETATION) 

Normal Replace Instruction Interpretation 

■•! 

k - Not used 

k = 1 Read: (Yj 5 Q ) - A ir } _Q (sign extended). 

Store: Store the lower 16 bits of the operand in bits 15-0 of 
address Y leaving the upper 16 bits of the contents of address Y 
unchanged. 

k .'= 2 Read: ( Y 3___^ ~* A i5-0 (si 9 n extended). 

Store: Store the lower 16 bits of the operand in bits 31-16 of 
address Y leaving the lower 16 bits of the contents of address Y 
unchanged „ 



Read: 
Store 
Read: 
Store 



(Y 3l-O j 



l 3l-0 



of the contents of address Y 



(Y 15-8 } 



Ay q (zero extended). 



Store the 32 bit operand at address Y. 
(Y_, q) - A^, q (zero extended) j 

Store the lower 8 bits of thi operand in bits 7-0 of 
address Y t leaving the upper 24 bits 
unchanged. 

k =■ 5 Read: 

Store: Store the lower 8 bits of th^ operand in bits 15-8 of 

address Y, leaving the remaining bit£ of the contents of address Y 
unchanged. 

k = 6 Read: 

Store: Store the lower 8 bits of th^ operand in bits 23-16 of 
address Y f leaving the remaining bits of the contents of address 
Y unchanged. 

k .= 7 Read: CY 3l-24 ) "* A j_o ( ' zero extende ^ l) • 

Store: Store the lower 8 bits of th£ operand in bits 31-24 of 



(Y 23-16 } 



Ay q (zero extended). 



the operand in bits 31-24 of address 



of the contents of address Y unchanged. 



Y, leaving the lower 24 bits 
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1 h - Index Register Code Designator 

The 3-bit b-desiynator specifies which of the index registers will be used to 
modify the operand address y-designator . B-registers are generally used for 
indexing loops in a program. In addition, the B7-register serves as a 
repeat counter and the BO-register indicates a register which always contains 
zero. There is a group of index registers for each state of the computer. 

12.3.5 i - Indirect Address Code Designator 

The i-designator is set by coding an asterisk (*) before the y field. The i- 
designator of the instruction word controls the use of indirect addressing and 
variable-length character addressing during execution. If i - 0, the instruc- 
tion will function normally. 

12.3.6 s - Base Register Code Designator 

The 3-bit s-designator is used to modify the 13-bit operand address y-designator 
to form Y = -y + B^ + S g . The base registers addressing technique is as 
follows: 



a) 


ooo 2 


— • 




(Add 


(s ) 


to 


y 






b) 


0(H 2 


— > 


s l 


(Add 


(s r ) 


to 


y 


+ 


(B b )) 


c) 


oio 2 




S 2 


(Add 


(s 2 ) 


to 


y 


+ 




d) 


on 2 


— ♦ 


S 3 


(Add 


(s 3 ) 


to 


y 


+ 


(B b )) 


e) 


ioo 2 




S 4 


(Add 


(s 4 ) 


to 


y 


+ 


(B,)) 


f) 


ioi 2 


— * 


S 5 


(Add 


(s 5 ) 


to 


y 


+ 


(B,)) 


g) 


no 2 


— ♦ 


S 6 >■ 


(Add 


(s 6 ) 


to 


y 


+ 


(B b )) 


h) 


111 2 




S 7 


CAdd 


(S ? ) 


to 


y 


+ 


(B,)) 



There are two sets of eight base registers, one for each of the task and inter- 
rupt states of the processor(s) . 

12.3.7 y - Operand Code Designator 

The operand y-designator is either a 13-bit value (zero extended) if k i 0, or 
a 16-bit value (sign extended) when k = 0. In the first case, the y-designator is 
part of the final operand address; in the other case it is a constant. 
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12.3.8 f^' " Subfunction Code Designators 

In an effort to minimize the number of different function codes, various 
instructions have subfunctions in all or part of the normal k-designator field. 
In place of the k -field, a whole-word interpretation of the operand is hardware 
assumed. 

12.3.9 m - Shift Counter Field 

This is a 7-bit field used in half-word shift instructions to specify the 
number of data bits in an A-register that will be moved either to the right or 
to the left. 

12.3.10 m - Monitor Interrupt Code Designator 

This is a special designator for input/output controller instructions con- 
sisting of a 1-bit monitor flag that, if set, will cause the IOC to transmit an 
interrupt to the processor when a buffer is terminated. 

12.3.11 c - Chain Flag Code Designator 

This is a special designator for input/output controller instructions con- 
sisting of a 1-bit chain flag that, if set, indicates to the IOC that another 
command follows. When the operation specified by this command terminates, the 
chain shall remain active. 

12.3.12 ,j - Channel Number 

This is a special designator for input/output controller instructions con- 
sisting of a 4-bit field specifying which channel (0 through 15) the associated 
IOC command is to be performed on. 

12.4 COMPUTER- INSTRUCT ION REPERTOIRE 

The assembler recognizes and generates for an imbedded computer-instruction 
repertoire associated with the AN/UYK-7 Computer! System. All mnemonic computer- 
instruction lines have the general format: 

Label Mnemonic Function Operand 

Use of a label is always optional. An asterisk (*) preceding the y field 
specifies indirect addressing and causes the Assembler to set the i-field of 
the generated instruction word to a one. 
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For convience of programming, the coding sequence of the operand subfield(s) 
does not necessarily correspond to the field order of the generated instruction. 

The material contained in this section presents the instruction repertoire in 
condensed form for reference purposes only. Programmers requiring more detailed 
information concerning the hardware operation should consult the appropriate 
hardware specification document. 

Note that the mnemonic function code for all half-word instructions begins with 
the letter H. 

For ease of reference, the instructions are grouped according to their 
function into eleven major categories as follows: Load and Store, Arithmetic, 
Jump, Comparison, Logical, Shifts, Control Memory References, Interrupt 
Handling, Miscellaneous, Extension Mnemonics and Input/Output. 

Within each group, instructions are arranged alphabetically by name. Format 
I and Format II instructions are character addressable and repeatable except 
as indicated. There is some unavoidable overlap in the above classification. 
For example, some of the logical type instructions involve arithmetic opera- 
tions. The list which follows may be consulted for corresponding names, 
mnemonics, and groups. 
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MNEMONIC NAME GROUP 



AA 


ADD A 


Arithmetic 


AB 


ADD B 


Arithmetic 


AEI 


ALLOW ENABLE INTERRUPT 


Interrupt 


AFC 


ACTIVATE EXTERNAL 
FUNCTION CHAIN ON Cj 


Input/Output 


AIC 


ACTIVATE INPUT CHAIN 
ON Cj 


Input/Output 


ALP 
ANA 


ADD LOGICAL PRODUCT 
SUBTRACT A 

(Add Negative A) 


Logical 
Arithmetic 


ANB 


SUBTRACT B 

f A H H Monat ivf» R 1 

VnUU KClj d I 1 V L L) / 


Arithmetic 


Aor 


AfTTVATF OUTPUT fHATN 
ON C j 


Tnniit /Out nut 
llipUt/v/Ut jJ U L 


AXC 


ACTIVATE EXTERNAL INTER- 
RUPT CHAIN ON Cj 


Input/Output 


BC 


COMPARE BIT TO ZERO 


Compari son 


BCW 


BUFFER CONTROL WORD 


Extension 


BCWE 


BUFFER CONTROL WORD ESI 


Extension 


BS 


SET BIT 


Miscellaneous 


BZ 


CLEAR BIT 


Miscellaneous 


C 


COMPARE 


Compari son 


CG 


COMPARE GATED 


Comparison 


CL 


COMPARE LIMITS 


Compari son 


CM 


COMPARE MASKED 


Compari son 


CNT 


COUNT ONES 


Mi seel 1 aneous 


r yt 

LAI 


UUIVirAKEi 1 INULA, llNUKU- 

MENTED 


Compa r i son 


D 


DIVIDE A 


Arithmetic 


DA 


DOUBLE ADD A 


Arithmetic 


DAN 


DOUBLE SUBTRACT A 
(Doubh; Add Negnt i ve A) 


Arithmetic 


DC 


D01I3LE COMPARE 


Compari son 


DJNZ 


DOUBLE JUMP A NOT ZERO 


Jump 
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MNEMONIC NAME GROUP 

DJZ DOUBLE JUMP A ZERO Jump 

DL DOUBLE LOAD A Load & Store 

DS DOUBLE STORE A Load & Store 

FA FLOATING POINT ADD Arithmetic 

FAN FLOATING POINT SUBTRACT Arithmetic 

(Floating Point Add 
Negative ) 

FANR FLOATING POINT SUBTRACT Arithmetic 

WITH ROUND (Floating 
Point Add Negative with 
Round) 

FAR FLOATING POINT ADD WITH Arithmetic 

ROUND 

FB INITIATE EXTERNAL FUNC- Input /Out put 

TION BUFFER ON Cj 

FD FLOATING POINT DIVIDE Arithmetic 

FDR FLOATING POINT DIVIDE Arithmetic 

WITH ROUND 

FM FLOATING POINT MULTIPLY Arithmetic 

FMIR SET EXTERNAL FUNCTION Input/Output 

MONITOR INTERRUPT 
REQUEST ON Cj 

FMR FLOATING POINT MULTIPLY Arithmetic 

WITH ROUND 

HA ADD (SUM) Arithmetic 

HAI ALLOW CLASS II INTER- Input/Output 

RUPTS 

HALT STOP PROCESSOR Miscellaneous 

HAN SUBTRACT (DIFFERENCE) Arithmetic 

Add Negat ive (Differ- 
ence) 

HAND AND Logical 

HC COMPARE, REGISTER Comparison 

HCB COMPARE Bb WITH Ba Comparison 

HCL COMPARE LIMITS, REGISTER Comparison 

HCM COMPARE MASKED, REGISTER Comparison 

HCP COMPLEMENT A Arithmetic 
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MNEMONIC NAME GROUP 

HD DIVIDE REGISTER Arithmetic 

HDCP DOUBLE COMPLEMENT A Arithmetic 

HDLC DOUBLE SHIFT LEFT Shift 

CIRCULARLY 

HDRS DOUBLE SHIFT RIGHT Shift 

FILL SIGN 

HDrtZ DOUBLE SHIFT RIGHT Shift 

FILL ZEROS 

HDSF DOUBLE SCALE FACTOR Miscellaneous 

HK HALF-WORD CONSTANT Extension 

HLB LOAD Ba WITH Bb 1 Load & Store 

HLC SHIFT LEFT CI RCULARY £hift 

HLCI LOAD INTERRUPT CMR Control Memory 

WITH A 

HLCT LOAD TASK CMR Control Memory 

WITH A 

HM MULTIPLY REGISTER Arithmetic 

HNO HALF WORD NO-OPERATION Extension 

HOR INCLUSIVE OR A (Logical Logical 

Sum) 

HPI PREVENT CLASS III Interrupt 

INTERRUPTS 

HRS SHIFT RIGHT FILL SIGN Shift 

HRT SQUARE ROOT Arithmetic 

HRZ SHIFT RIGHT FILL ZEROS Shift 

HSCI STORE INTERRUPT CMR Control Memory 

IN A 

HSCT STORE TASK CMR IN A Control Memory 

HSF SCALE FACTOR Miscellaneous 

HSIM STORE I/O MONITOR CLOCK Miscellaneous 

HSTC STORE REAL TIME CLOCK Miscellaneous 

HWFI WAIT FOR INTERRUPT Interrupt 

HXOR EXCLUSIVE OR A (Logical Logical 



Di f ference) 
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IB INITIATE INPUT BUFFER Input/Output 

ON Cj 

IBS SET BIT Input/Output 

IBZ CLEAR BIT Input/Output 

ILTC LOAD REAL-TIME CLOCK Input/Output 

IMIR SET INPUT MONITOR INTER- Input/Output 

RUPT REQUEST ON Cj 

JBNZ INDEX JUMP (Jump B not Jump 

zero) 

10 INITIATE INPUT/OUTPUT Miscellaneous 

IPI INTERPROCESSOR INTERRUPT Interrupt 

ITSF TEST AND SET FLAG Input /Out put 

IW INDIRECT WORD Extension 

IWB INDIRECT WORD, SPECIAL Extension 

INDEX 

IWC INDIRECT WORD, CHARACTER Extension 

IWCI INDIRECT WORD, CHARACTER Extension 

INCREMENT 

IWS INDIRECT WORD, SPECIAL Extension 

BASE 

J JUMP Jump 

JC JUMP CONDITION SETTING Jump 

JE JUMP EQUAL Jump 

JEP JUMP EVEN PARITY Jump 

JG JUMP GREATER THAN Jump 

JGE JUMP GREATER THAN OR Jump 

EQUAL 

JIO JUMP (INPUT/OUTPUT) Input/Output 

JL JUMP LOWER Jump 

JLE JUMP LESS THAN OR EQUAL Jump 

XT JUMP LESS THAN Jump 

JN JUMP A NEGATIVE Jump 

JNE JUMP NOT EQUAL Jump 

JNF JUMP NO OVERFLOW Jump 
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JNW JUMP NOT WITHIN LIMITS Jump 

JNZ JUMP A NOT ZERO Jump 

JOF JUMP OVERFLOW Jump 

JOP JUMP ODD PARITY Jump 

JP JUMP A POSITIVE ' Jump 

JS JUMP Sy + B Jump 

JSC JUMP STOP CONDITIONAL Jump 

SETTING 

JW JUMP WITHIN LIMITS Jump 

JZ JUMP A ZERO Jump 

LA LOAD A Load 6 Store 

LB LOAD B Load & Store 

LB J LOAD B AND JUMP Jump 

LBMP LOAD BASE AND MEMORY Load & Store 

PROTECTION 

LCI LOAD INTERRUPT CMR Control Memory 

LCT LOAD TASK CMR Control Memory 

LDIF LOAD DIFFERENCE Load & Store 

LICM LOAD IOC CONTROL MEMORY Input/Output 

LIM LOAD, ENABLE IOC MONITOR Miscellaneous 

CLOCK 

LLP LOAD LOGICAL PRODUCT Logical 

LLPN LOAD LOGICAL PRODUCT Logical 

NEXT 

LM LOAD MAGNITUDE Load & Store 

LNA LOAD NEGATIVE Load & Store 

LSUM LOAD SUM Load & Store 

LXB LOAD A & INDEX B Load & Store 

M MULTIPLY A Arithmetic 

MP MEMORY PROTECTION Extension 

MS SELECTIVE SUBSTITUTE A Logical 

NLP SUBTRACT LOGICAL PRODUCT Logical 

(Add Negative Logical 
Product) 
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NOOP NO OPERATION Extension 

OB INITIATE OUTPUT BUFFER Input /Out put 

OMIR SET OUTPUT MONITOR Input/Output 

INTERRUPT REQUEST 

OR INCLUSIVE OR (SELECTIVE Logical 

SET) 

PEI PREVENT ENABLE INTERRUPT Interrupt 

RA REPLACE ADD Arithmetic 

RALP REPLACE A + LOGICAL Logical 

PRODUCT 

RAN REPLACE SUBTRACT Arithmetic 

(Replace Add Negative) 

RD REPLACE DECREMENT Arithmetic 

RI REPLACE INCREMENT Arithmetic 

RJ RETURN JUMP Jump 

RJC RETURN JUMP CONDITIONAL Jump 

RJSC RETURN JUMP STOP CONDI- Jump 

TIONAL SETTING 

RLP REPLACE LOGICAL PRODUCT Logical 

RMS REPLACE MASK (SEL. SUB- Logical 

STITUTE ) 

RNLP REPLACE A - LOGICAL Logical 

PRODUCT (Replace Add Neg- 
ative Logical Product) 

ROR REPLACE INCLUSIVE OR Logical 

(Replace Selective Set) 

RP REPEAT Miscellaneous 

RSC REPLACE SELECTIVE CLEAR Logical 

RXOR REPLACE EXCLUSIVE OR Logical 

(Replace Selective Com- 
plement) 

SA STORE A Load & Store 

SB STORE B Load & Store 

SC SELECTIVE CLEAR Logical 

SCI STORE INTERRUPT CMR Control Memory 
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SCT STORE TASK Control Memory 

SDIF STORE DIFFERENCE Load & Store 

SICM STORE IOC CONTROL MEMORY Input/Output 

SLP STORE LOGICAL PRODUCT Logical 

SM STORE MAGNITUDE Load & Store 

SNA STORE NEGATIVE Load & Store 

SSUM STORE SUM Load & Store 

SXB STORE A AND INDEX B Load & Store 

SZ STORE ZERO Extension 

TBS TEST BIT SET Input/Output 

TBZ TEST BIT CLEARED Input/Output 

TFB TERMINATE EXTERNAL FUNC- Input/Output 

TION BUFFER ON Cj 

TIB TERMINATE INPUT BUFFER Input/Output 

ON Cj 

TOB TERMINATE OUTPUT BUFFER Input/Output 

ON Cj 

TSF TEST AND SET FLAG Miscellaneous 

TXB TERMINATE EXTERNAL INTER- Input/Output 

RUPT BUFFER 

XB INITIATE EXTERNAL INTER- Input/Output 

RUPT BUFFER 

XMIR SET EXTERNAL INTERRUPT 

MONITOR INTERRUPT Input /Out put 
REQUEST ON Cj 

XOR EXCLUSIVE OR (SELECTIVE Logical 

COMPLEMENT) 

XR EXECUTE REMOTE Miscellaneous 

XRL EXECUTE REMOTE LOWER Miscellaneous 

XS ENTER EXECUTIVE STATE Miscellaneous 

ZA CLEAR A Extension 

ZB CLEAR B Extension 
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12.4.1 Load and Store Instructions 

Generally, load instructions load a register or registers with: 1) the con- 
tents of memory; 2) the contents of memory plus or minus the contents of an 
accumulator register; or 3) the contents of memory in absolute magnitude or 
complemented. In format I instruction, k is the normal read designator. Store 
instructions store the following in memory: 1) the contents of a register 
or registers; 2) the sum or difference of consecutively numbered accumulator 
registers; or 3) an accumulator register in absolute magnitude or com- 
plemented . 

The following are the formats for load and store instructions: 
DOUBLE LOAD A 



31 |SO|2*|2t]27|2« 


2S|2«]23 


22|ZI [20 


l»[lt|lT 




lSjl«Jl3 


.2|M|.0|»|a|r|«|»|4|3|2|l|0 


05 


a 


4 


b 


i 


s 


y 



DL a,y,b,s 



(Y + 1 f Y) -* A ■ A 
* a+1 a 



Not character addressable. 
Not repeatable. 

Load the double length register (formed with the lease significant half 

in A„ and the most significant half in A tl ) with the content of the 
a a+1 

double length memory word, formed with the least significant half as (Y) 
and the most significant half as (Y + 1). 



DOUBLE STORE A 



3l|30|z*|2t|27(2« 


2S|2«|2J 


22|2l|20 


It|li|l7 


It 


I9|l«|l5 




02 


a 


7 


b 


i 


s 


y 



DS a f y f b,s 



(A A ) - Y + 1, Y 
a+1 a 



Not character addressable. 
Not repeatable. 
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Store the content of the double length register (formed with the least 

significant half in A and the significant half in A ) at the 

d a+1 
double length memory word (formed with Y as the least significant half 

and Y + 1 as the most significant half). 



LOAD A 
».|»o|»»l»iar| ? » 



10 



25 124 23 



It It 17 



IS 14 13 



■H»M.|.l»UI.UI.T7m7 



LA a,y t k,b t s 



Y - A 



Load A with Y. 
a 



LOAD A AND INDEX B 



3' lS0|29|2t|27|28 


2»|*« 


ffiESE9SSflQIDIDDIDDQCD 


>Cit|t|7|t|t|4|3|2|l|0 


11 





k 




b 


i 


s 


y 



LXB a,y t k f b,s 



Y - \ ; (B ) < 1 - B 
a b b 



Not repeatable. 



Load A with Y and add one to (B, ). 
a - b 



LOAD B 



DJfflmOBBfflEBEQffi 


ESSIES 




it 


I 9 |.«|i3 


.2j..|.O|t|t|7|t|»|4|3|2|.|0 


20 

i 


a 


k 


b 


i 


s 


y 



LB a t y t k,b f s 



Y - B 



The a sub-field specifies an index register. 



Load B with Y. If B is B , the effect is a no-operation. 

a - a o v 
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LOAD BASE AND MEMORY PROTECTION 



51 |50|l» 


□DEEDED EE 


QODoaiDDDDiDiaioiDaiiQDoaaaDaaoa 


05 




4 


b 


i 


s 


y 



LBMP a,y,b,s 



Y 

Y + 1 



- SPR. 

< 

- SIR. 



S - 191? 

y + (B D ) - SIR a 15-0 



Not character addressable. 
Not repeatable. 

This instruction loads the task state base register, specified by the a- 
field, with the lower 18 bits at address Y, and loads the Storage Protec- 
tion Register specified by tha a-field, with the lower 21 bits of 
address Y + 1. The Segment Identification Register, specified by the a- 
field, receives the s-field value in bits 19 through 17 and the sum of 
y + (b^ in bits 15 through 0. This instruction can be executed in the 
task state under the following conditions: 

1. Bit of the Active Status Register must be set. 

2. The s-field must equal seven. 

3. The a-field must not equal seven. 

A violation of these conditions shall cause a privileged instruction 
interrupt (class II). 

The following condition applies to this instruction in both the task and 
interrupt states: 

The 17-bit relative address quantity, y + ^ B d^ must be an even number. 

Its violation shall be an illegal instruction error causing a class II 
interrupt. 
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LOAD B WITH B 
a b 



>9{ '«] >sj 12] 1 1 (iO 


.|.|T 




>|.|, 





7 1 


a 


3 


b 


i 



IILB a,b 



(B. ) - B 
b a 



The a sub-field specifies an index register. 

Load B with (B,). If B is B , the effect is a no -opera t ion . I f B, is 

a b a r b 

B , B is cleared to zero. 
a 



LOAD DIFFERENCE 



31 |50}l9|2l|2r]26 


"IH" 


22|2l}20 




Hjl7 


l« 






12 


a 


k 


b 


i 


s 


y 



LDIF a f y f k,b,s 



Y - (A ) -* A (A )i = (A )f 

~ a a+1; a a 



Load A^ +1 with the difference formed by subtracting (A^) from Y. 
remains unchanged. 

LOAD MAGNITUDE 



(A ) 
a 



9t|30|2»j2S|27|2S 


29]24|23 


22)21 J20 


itjia] 17 


IS 


.s|.«|.3 


.2|..|<0|»|t|7|.|s|4| 9 |2|.|0 


17 


a 


k 


b 


i 


s 


y 



LM a , y t k , b , s 



Y| - A 



Load A with the absolute value of Y. 
a — 



LOAD NEGATIVE 



3i [30|?9]2l|27[2S 


23|2«|23 


"hi 20 


"hi 7 




I5|l«|l3 




LNA a,y,k t b t s 


1 O 


,1 


k 


b 


i 


s 


y 



Y' - A 



Load A with the logical complement (ones complement) of Y. 

a 
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LOAD SUM 



3,|30|2»iZlM*« 


29|24|23 


"M 10 


l»| l«| IT 


It 


IS|.4|. S 


.>|..|.0|t|t|7|.|»|4| S |2|.|0 


If) 




k 


I) 


i 


s 


y 



LSUM a,y f k,b,s 



Y + (A ) - A J _. ; (A ). = (A ) f 
- a a+1 a 1 a i 

Load A , with the sum of Y and (A ). (A ) remains unchanged. 

a "> l a a 



STORE A 



3l|30[2»|2«[27|l6 


23|2«|23 


22|2l|20 


It|ll|l7 


it 


IS|)4||S 


•«l"l'0|t|l|7|t|5|4|3|2|.|0 


24 


a 


k 


b 


i 


s 


y 



SA a t y,k t b,s 



(A ) - Y 
a 



Store (A ) at Y. 
a 



STORE A AND INDEX B 



3l|30|2t|2t|27|2« 




22|2l|20 


I»|ll|l7 


it 






25 


a 


k 


b 


i 


s 


y 



SXB a,y,k,b,s 



(A ) - Y; (B u ) + 1 - B. 
a b b 



Not repea table. 



Store (A g ) at Y; add one to (B b > and store the sum in the B fa register 



STORE B 



3l|30|2*|2S|27|2t 


23|24|23 


22]2l|20 


It|.t|l7 


it 


It|l4jl3 




23 


a 


k 


b 


i 


s 


y 



SB a,y,k,b,s< 



(B ) -» Y 

a 

The a sub-field specifies an index register. 



Store (B ) at Y . 
a 
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STORE DIFFERENCE 



Si |30|29|28|27|26 


23]2«]23 


22(21 [20 


<9|.l|<7 




isji«|is 


I2j 1 1 1 tO ] 9 


• l'M»M>M 


1° 


()2 


.') 


6 


b 


i 


s 


y 



SDIF a t y,b,s 



(A ) - (A ) - Y and A ; (A ) . ' = (A ) r 
a^l a a+1 a l a f 



Subtract (A ) from (A',). The result is noted at Y and A 

a a+1 a+1 

remains unchanged. 
STORE MAGNITUDE 



(A.) 
a 



3i |30|29]2l]2 7|26 




:-|-.|io 


>9|lt|l7 


it 


is|i«|u 


.2|..|.0|9|9|7|.|3|4|3|2il|0 


. 27 


a 


k 


b 


i 


s 


y 



SM a f y t k,b,s 



Store the magnitude of (A^) a»t Y. 



STORE NEGATIVE 



3.|30|29|2.|27|" 




22}2 1 [20 


19 


1 • 1 1 T 


l« 




'2|"|.0|9|i|7|.|»|«|3|2|.|0 


26 


a 


k 


b 


i 


s 


y 



SNA a,y f k,b f s 



(A )' - Y 

a 

Take the complement of (A^) and store the result in Y. 



STORE SUM 

3l|30}29[2»[27|2e 



02 



23|2«|2i 



22|2l|20 



19 1 1*1 IS 



,2[..|.0l9H|7[« [3|4|3[2|.|0 



SSUM a t y,b t s 



(A ) + (A -Y and A ,.;-(A). = (A K 
a a+1 a+1 a l a f 



Add (A ) to (A ,,.). The result is stored in A and Y. (A ) remains 
a a+1 a+1 a 

unchanged. 
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12. 1.12 Arithmetic Instructions 



These j'jsl rue. I ions change the contents of a specified register or registers 
according to the operation specified, except for the replace instructions 
which also modify the contents of memory. Some instructions in the LOAD AND 
STORE and LOGICAL sections also involve arithmetic operations. 

ADD A 

IS? 



3l|S0|t»|»t||7|f 



11 



It lit 17 



19 14 19 



33 



10 



9 2 10 



y 



AA a t y f k,b f s 



(A ) + Y -» A 

a - a 

Form the sum of (A ) and Y. snd store the result in A 

a -b a 



ADD (SUM) 



I3|l*|l5|i2|ll|l0 


•hh 


•hh 


'hi' 




71 


a 


i 


b 


i 



HA a,b 



(A ) + (A. ) - A ; (A, ). = (A.), 
a b a b l b f 

Form the sum of (A ) and (A.) and store the result in A . 

a b a 



ADD B 



9i]90|2»|2l|27|2« 


2 5] 2 4] 2 3 


22|2l|20 


It|is|l7. 




I9|l4|l9 




21 


a 


k 


b 


i 


s 


y 



AB a,y,k t b f s 



(B ) + Y -♦ B , where reference is to an index register in sub-field a 
a a 

If Bg is B^, the effect is a no-operation, k is normal read. 



COMPLEMENT A 



I9|l4|l9|l2|ll|l0 


•1*1* 


•hi* 


3|2|. 





70 


a 


2 


b 


i 



HCP a 



(A )». - A 
a a 

Complement (A ) and store the result in A . 

a a 
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DIVIDE A 



31 J30]2»|2S|27|2« 


2S|2«|23 


22|2 1 ]20 


.•|.l|<7 


It 


!S|l4jlS 


> 2 |..|io|t|e|r].|»|«|,| 2 |.|o 


■41 


n 


k 


1) 


i 


s 


y 



D a,y,k,b f s 



^■'\ n +]». ^ a ^ v Y A ; remainder 



a+1 



Divide* I he content- of the double 1 length register (formed with the least 

significant half in A g and the most significant half in A j) by Y. The 

quotient is stored in A and the remainder in A Divide overflow 

1 a a+1 

shall occur if the quotient exceeds 31 data bits and one sign bit. 



DI VI UK REGISTER 



l9 l i4 l ,3 l l2 l"] 10 




.[»|« 


>|.|. 





71 


n 


1 


h 


i 



11D a,b 



(A , . t A) t (A. ) - A ; remainder - A 
a+1 b a a+1 



Divide the double length register (formed with (A ) as the least signi 

a 

ficant half and (A j ) as the most significant half) by (A^). The 

quotient is stored in A and the remainder in A , ' (A.). = (A,),, if 

a a+1 b i b f 

a / b and a+1 ^ b. 
DOUBLE ADD A 



*I 50 M 2, M" 




22|2I |20 


I*[li|l7 


It 


is|l«|l3 


. 2 |..|.0|t|«|7|t|5|4|3| 2 |l|0 


05 


n 


1 


b 


i 


s 


y 



DA a f y,b f s 



Not character addressable. 
Not repeatable. 

(Y+l. W + CA . A a ) -A a+1 . A a 



Form the sum of the content of the double length register (formed with 

t he least significant half in A g and the most significatn half in A ') 

and the content of the double length memory word (formed with the least 

significant half at Y and the most significant half at Y + 1). Store the 

hast significant half of the result in A and the most significant half 

a 



in A 



a^ 1 ' 
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DOUBLE COMPLEMENT A 



'»I'*1 ,S I' 2 I" I'° 


• |.|T 




• |«|. 





70 


a 


3 


b 


i 



HEiCP a 



(A i-it A) - * A , . • A 
a+l a a+l 

Complement the double length register (formed with (A ) as the least 

a 

significant half, and (A g+ ) as the most significant half) and store the 

most significant half of the result in A g+1 and the least significant 

half in A . 

a 



DOUBLE SUBTRACT A 



31 |30|*»|2«]l7|l« 


2S]2«|2S 


22|Zl|20 


I»|H||7 


It 


is|l*jl3 






h 


05 


a 


2 


b 


i 


s 


y 



DAN a f y,b f s 



Not character addressable. 
Not repeatable. 

(A ,_, A ) - (Y+l, Y) -* A X1 , A 
a+l a a+l a 

Subtract the content of the double length memory word (formed with the 

least significant half at Y and the most significant half at Y + 1) from 

the content of the double length register (formed with the least signify 

icant half in A and the most significant half in A ,). Store the least 
a a ■ i 

significant half of the result in A and the most significant half in 

a 

A . . 

a+l 

FLOATING POINT ADD 



□EBQDEDQD S3 S1ES3Q3 ESSIES 


OBDBiQBBBOBaaaaaaaDiiQ 


06 


a 





b 


i 


s 


y 



FA a,y,b t s 



Not character addresable, 
Not repeatable. 
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Compare the characteristic stored at Y with the characteristic located in 

the lower 16 bits of A . The mantissa located at Y + 1 or the mantissa 

a 

located in A g+1 is then shifted, depending on the comparison of the 

characteristics. (Y + 1) is then added to (A ,,). The normalized shift 

a+1 

count is then subtracted from, or added to the final characteristic lo- 
cated in A . 



FLOATING POINT ADD WITH ROUND 



3i |50j29|2«|27)2« 




22(2) ]20 


l9|l«| 17 


it 


IS||4||3 


.2|..|.0j»| a |7|«|3|4|3]2].]0 


o<-> 




4 


b 


i 


s 


y 



FAri a,y,b, s 



Not character addressable. 
Not repeatable. 

Compare the characteristic stored at Y with the characteristic located 
in the lower 16 bits of A . The mantissa stored at Y + 1 or the mantissa 

d 

located in A g+] is shifted, depending on the comparison of the charac- 
teristics. The final mantissa is rounded as required. The normalized 
shift count is subtracted from, or added to, the final characteristic 

located in A . 

a 

FLOATING POINT DIVIDE 



31 |30|29|2S|27|26 




22(21 [20 


.9|.l|.7 




"I 14 ! 11 


. 2 |..|.0|9|t|7|«|s|4|3|2|l|0 


06 


a 


;} 


b 


i 


s 


y 



FD a,y,b,s 



Not character addressable. 
Not repeatable. 

Subtract the characteristic located at Y from the characteristic located 

in the lower 16 bits of A . The mantissa located in A is then divided 

a a+1 

by 1 he mantissa located at Y + 1. The final mantissa located in A g+1 is 
normalized right one place if necessary and the characteristic adjusted 
accordingly. 
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FLOATING POINT DIVIDE WITH ROUND 



3i|SO|29|2S|27]2e|t9|2«|2S 


22[2l|20 


I*|ll|l7 




I9|l4[ia 


I2|ll(l0(t|l|7|«|5|4|s|2| I |0 


Ufa | „ 


7 


b 


i 


s 


y 



FDR a , y , b, s 



Not character addressable. 
Not repeatable. 

Subtract the characteristic located at Y from the characteristic located 

in the lower 16 bits of A . The mantissa located in A , _ is then divided 

a a+1 

by the mantissa located at Y + 1. The mantissa located in A g+1 is nor- 
malized right one place if necessary and the characteristic adjusted 
accordingly. The final quotient mantissa, ( A a+1 )» is rounded as required 

FLOATING POINT MULTIPLY 



■»' j* ! -9|26|27|2« 


29|24|23 


22|2l[20 


l«|lt|lT 


it 


.»|l4|.» 


l2|M|l0|t|t|7|«|3|4|s|2|l |C 


06 


a 


2 


b 


i 


s 


y 



FM a t y,b,s 



Not character addressable. 
Not repeatable. 

Add the characteristic located at Y to the characteristic located in the 

lower 16 bits of A g . The mantissa located in A g+ ^ is then multiplied by 

the mantissa located at Y ■+ 1. The final mantissa located in A is 

a+1 

normalized left one place if necessary and the characteristic adjusted 
accordingly. 



FLOATING POINT MULTIPLY WITH ROUND 



5l|SO|2»|2ej27j« 












■2|»'|toj* 




06 


a 


6 


b 


i 


S 


y 



FMR a,y,b t s 



Not character addressable. 
Not repeatable. 
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Add the characteristic located at Y to the characteristic located in the 

lower 16 bits of A g . The mantissa located in A g+1 is then multiplied by 

the mantissa located at Y + 1. The mantissa located in A is nor- 

a+ 1 

malized left one place if necessary and the characteristic adjusted 
accordingly. The final mantissa, (A a+1 >, is then rounded as required. 



FLOATING POINT SUBTRACT 



3i]S0j2*|2»(2r]2« 




22|2i]20 


is] i a 1 ir 


it 


l3jl«]lB 


. 2 |..|.ol.i.|r|»|5|«ls|2|. {0 


()() 




1 


b 


i 


s 


y 



FAN a t y,b f s 



Not character addressable. 
Nor repeatable. 

Compare the characteristic stored at Y with the characteristic located in 

the lower 16 bits of A . The mantissa located at Y + 1 or the mantissa 

a 

located in A g+1 is then shifted depending on the comparison of the char- 
acteristics. (Y + 1) is then subtracted from the (A ,,). The normalized 

a+1 

shift count is then subtracted from, or added to, the final characteristic 

located in A . 

a 

FLOATING POINT SUBTRACT WITH ROUND 



3l|30|2t|2l]27|2« 


29|2«[23 


22[2 1 [20 


I9|li| 17 


It 


I9|l4|l3 


.2|..|.0|»|.|7|t|s|4|3|2|.|0 


00 


:i 


5 


b 


i 


s 


y 



FANR a,y,b,s 



Not character addressable. 
Not repeatable. 

Compare the characteristic stored at Y with the characteristic located 

in the lower 16 bits of A . The mantissa located at Y + 1 or the man- 

a 

tissa located in A a+1 is shifted depending on the comparison of the 

characteristics. (Y + 1) is then subtracted from(A ..). The final 

a+1 

mantissa is rounded as required. The normalized shift count is then 



subtracted from, or added to, the final characteristic located in A . 

a 
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LILT I PLY A 



Si|30|2*l2*|2 7 2t 




22|Z 1 120 


it|,i|.r 


it 


I9|l4|l3 


.2(..|.0|t|t(T|«|»(4|»h|.(0 


40 


a 


k 


h 


i 


s 


y 



M a,y,k,b f 



(A ) x Y - A ... A 

a - a+1 a 

Multiply (A ) by Y, store the least significant half of the double length 

result in A , and the most significant half in A ... 

a a -1 "] 



MULTIPLY REGISTER 



iS|l«|l3|i2|n|iO 


.|.|t 




.|.|. 





74 


a 







i 



HM p.b 



(A ) x (AJ -* A , A 
a b a+1 a 



Multiply (A ) by (A b ). The least significant half of the double length 
result is stored in A gf and the most significant half in A a+J • ^bV" 



(A. )f if a f b and a+1 i b. 

D 



REPLACE ADD 



3l|30|2»|2»|2T|2t 


29|2«|23 


22[2l[20 


I»|njl7 


it 


I9[l«|l3 


.2|H|.0|»|t|r|t(5|4|3| 2 |.|0 


34 


a 


k 


b 


i 


s 


' y 



RA a,y,k,b,s 



Y + (A ) - Y and A , (A ) . = (A ) r 
~ a a+1 a l a f 



Form the sum of Y and (A ) , and store the result at Y and A . (A ) 

a a+1 a 

remains unchanged. 
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RI PI ACi; INCREMENT 







■»M ,s 






D 


a 


i 


s 


y 



RI a,y,k,b,s 



V +1 - A and Y 
— a 



Load A a with Y, then add one to (A ) and store the result at A and Y 

a 

REPLACE DECREMENT 



Si (S0[2»|2l[2 7|2« 


2S|2«(25 


22(21 jio 


■■•M" 


it 




.2|..|.0|t|t|r|t(»|4|3|2|.|0 




37 


a 


k 


b 


i 


s 


y 


RD a,y f k,b,s 



Y - 1 - A and Y 
— a 

Load A with Y, then subtrac t one from (A ) and store the result at A and Y, 
a a a 



REPLACE SUBTRACT 



3i|S0|2»|2t|27|2t 


2S|2«(2» 


22|2.|20 


I»|lt|l7 


it 


)9|l«|lS 


-2|«.|.0|t|t|7|t|»|4|s|2|.|0 


36 


a 


k 


b 


i 


s 


y 



RAN a,y,k,b f s 



Y - (A ■) - Y and A ; (A ) . = (A ). 
_ a a+1 a 1 a f 



Subtract (A ) from Y., then store the result in Y and A 

a "" a+1 



unchanged . 
SQUARE ROOT 



(A g ) remains 



,9 l' 4 hM"l'° 


• |.|T 


• |.|« 


>|.|. 





74 


a 




b 


i 



HRT a,b 



(A , lt A ) - A, ; residue - A, 
a+l f a b b+1 



Calculate the square root of the content of the double length register 

(formed with the most significant half in A g+ ^ and the least significant 

half in A ). The result is stored in A. and the residue is stored in 
a b 

Vr 

(A +1) .= (A ) if a+1 f b and a+1 f b+1 
" J a+i i 



(A ). = (A ) if a f b and a f b+1 

a 1 a 1 
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SUBTRACT (DIFFERENCE) 



I9fi«|l3|i2]ll|l0 


.|.|T 


• |.|« 


>|a|. 





71 


a 


2 


h 


i 



LAN a,b 



(A ) - (A. ) - A 
a b a 



Subtract the (A L ) from (A ) and store the result in A . (A. ). 

b a a b l 



SUBTRACT A 



3i[30|29|2*|27|2t 




22|2l|20 


I»|li|l7 


it 


I9|u(l3 


•2|"|.0|.| < |r|.|»|4|3|2|.|0 


ANA a,y,k f b,s 


13 


a 


k 


b 


i 


s 


y 



(A ) - Y A 

a - a 



Subtract Y from (A ) and store the result i n A . 

~ a a 



SUBTRACT B 



3l|30|29|2i|27|2« 




22|2l|20 


I»|lt|l7 


it 


I3|u|l3 




t-L. 


a 

,. i 


k 


b 


i 


s 


y 



ANB a f y f k f b,s 



(B ).. -. Y - B 
a - a 



a - index register 



Subtract Y from (B ) and store the result in B . If B is B , the effect 
~ a a a o* 

is a no -operation . 
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12.4.3 Jump Instructions 

There are 2B jump instructions and all are Format III. Zero is the only 
possible value in the K field of an assembled jump instruction, so the 
Assembler ignores any value in the k sub-field of a corresponding source line. 
In the descriptions below, Y is regarded as a relative address formed by 
adding ( B b ) 15 _ to y zero extended. If the jump is taken, this quantity is 
transferred to P (1C ._ ()) and the s-designator is transferred to P^ l9 If the 

jump is not taken, the next instruction in sequence is executed. 



JUMP 



Si|BO|29|za|27|2e 


2S|2«[23 


22|2. 


20 


IS|l«|l7 


it 


.»|.«|is 


.2|..|.0]*|.|7|.| 9 |4|>|2|.|0 


.13 


n 


3 





b 


i 


s 


y 



J y,k,b t s 



Y - P 

Jump unconditionally to address Y. 
INDEX JUMP 



5.|30|29|2 # |27|2. 


29|2«|23 


22|2. 


20 


19 1 1«| 17 


it 


19 1 14 ] 1 3 


' 2 |n|.0|.|.|7|.|,|4h|2 


.|o 




f)2 




1 


[) 


b 


i 


s 


y 


JBNZ a,y,k,b,s 



If (B ) f 0, then (B ) - 1 - B . and jump to Y. If (B ) - 0, take NI 
a a a a 

If B^ = B^, the effect is a no-operation. 



DOUBLE JUMP A NOT ZERO 



3l|30(2»|2»|27 


2t 


23(24|23 


22|2. 


20 


l«[l«| 17 


it 


I5|.«|.S 


'2lnl.0l.ltl7lthl4hl2l.l0 


50 




3 





b 


i 


s 


y 



DJNZ a,y,k,b f s 



If CA j, A g ) f 0, jump to Y. 

where (A^^, A g ) is the contents of the double length register formed 

by A , and A . 

J a+1 a 
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DOUBLE JUMP A ZERO 



9l|90|2t|2t|27|2t 


I5|l«|l3 


22[ZI 


20 


i»|iijir 


i« 


is|i4|o 




50 


a 


2 


f) 


I) 


i 


s 


y 



DJZ a,y,k,b,s 



If (A a+1 , A g ) = 0, jump to Y. 

where (A , A ) is the contents of the double length register formed 
a j a 

by A and A . 
J a+1 a 



JUMP A NEGATIVE 



Sl|S0|2»|2l]27]2C 


25|2«|29 


22]2I 


20 


Iijli|l7 


it 


is|l4]l9 


.2l..|.0|*|t|7|«|5|4|9|2|.|0 


51 


a 


1 





b 


i 


s 


y 



JN a,y,k,b t s 



If (A ) < 0, jump to Y. 

9 



JUMP A NOT ZERO 



9l|90|2«|2«|27[2« 


29|24|29 


22|2I 


20 


It|lt|l7 


IS 


.9|.4|.9 








1° 


51 


a 


3 





b 


i 


s 


y 



JNZ a t y,k,b,s 



If (A ) f O f jump to Y. 
a 



JUMP A POSITIVE 



9l|90|2t|2l|27|2« 


29|24|29 


22(21 


20 


It|ll|l7 


It 


IS|l4|l9 




51 


a 








b 


i 


s 


y 



JP a,y,k,b f s 



If (A ) £ 0, jump to Y. 

3 



JUMP A ZERO 



9l|96|2«|2t|27|2t 


29|24|29 


22|ZI 


20 


I»|lt|l7 


It 


I»|l4|l9 




JZ a,y,k,b,s 


51 


a 


2 





b 


i 


s 


y 



If (A ) = 0, jump to Y. 

9 
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JUMP CONDITIONAL SETTING 



9l]SO|2»|Z»|27|2« 


as|i«|i3 


22|2I 


20 


..|.i|.r 


it 


4«h 




53 


a 


3 





b 


i 


s 


y 



If the value of the a sub-field, (1, 2, or 3) corresponds to a manual 

switch which has been selected, then jump to Y. 

SPECIAL FUNCTION 
a -VALUE PERFORMED 



Jump if switch 1 is selected 
Jump if switch 2 is selected 
Jump if switch 3 is selected 



JUMP CONDITIONAL STOP SETTING (PI) 



Sl|so|2t|2»|27 2« 


29|24|23 


22|2I 


20 


.»|.t|.7 


i« 


.9|.«|.l 


«2|"l'0|.|t|7|.|9|4| S |2|.|0 




53 


a 


3 





b 


i 




y 


JSC a t y,k,b,s 



If the value of the a sub-field (4,5,6, or 7) corresponds to a manual 
switch setting, then stop the processor, and transfer Y to P. 



1 
2 
3 



SPECIAL FUNCTION 
a-VALUE PERFORMED 

4 Always stop, then jump. 

5 Stop and jump if switch 5 selected. 

6 Stop and jump if switch 6 selected. 

7 Stop and jump if switch 7 selected. 



JUMP EVEN PARITY 



9t|SO|2t|2t|27|2t 


29|2«|29 


22|2I 


20 


.t|.l|.7 




.9|l4|.9 


<*l"|.0|f|t|7|.|»|4|3|2j. jo 


50 


a 








b 


i 


s 


y 



If the logical product of (A g ) and (A g+ j) contains an even number 
of binary ones, jump to Y. 
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JUMP EQUAL 



3.|30|l.|!.|>7|" 


29j2«|lS]22|2l 


20 


.t|.s|,r 


it 


.»|.4|.3 






53 


5 





b 


i 


s 


y 


JE y,k,b t s 



If CD is set to equal, jump to Y. 
JUMP GREATER THAN 



9l|SO|29(2S|27|2« 


29|2«|23|22|2I 


20 


.•|.l|.T 


it 


I9|l«|l9 


>2|"l«0|t|t|7|t|9|4|9|2| 




53 


11 





b 


i 


S 


y 



JG y,k,b,s 



If the CD is set to greater than, jump to Y. 
JUMP GREATER THAN OR EQUAL 



□□EncDEEDDDEtBEZiEDDiDiDinnDEniEnaannnDnna 


53 


15 





b 


i 


s 


y 



JGE y,k f b,s 



If the CD is set to greater than or equal, jump to Y. 
JUMP LESS THAN 



>.|30|2»|2t|2T|2t 


29|24|29|22|2I 


20 


.9|.t|.r 


it 


I9|l4|.3 


"|"|'°|'| S | 7 |«l»| 4 | S i 2 l'l 


JLT y,k,b,s 


53 


21 





b 


i 


s 


y 



If CD is set to less than, jump to Y. 
JUMP LESS THAN OR EQUAL 



3l|90|2.|2t|27|2t 


29|24|23|22|2I 


20 


.•|..|.7 


It 


IS|l4|lS 








1° 


53 


25 





b 


i 


s 


y 



JLE y,k,b,s 



If CD is set to less than or equal, jump to Y. 
JUMP LOWER 



3l[30|29|2t|27[2t 


29|24|23 


22)21 


20 


It|lt|l7 


It 


.9|.4|.3 




52 


a 


3 


I) 


b 


i 


s 


y 



JL y f k,b, s 



Y -» P • 

L V 



Jump to the 16-bit instruction contained in the lower half of the word 
whose address is Y. 
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JUMP NO OVERFLOW 



51 |30|*»|2i|*7|2« 


2S|24|23|22|ZI 


20 


I«(lt|l7 


19 


I»]l4|l3 


•2|H|iO|.|«|7| t |8|4|»|2|.|0 




53 


00 





b 


i 


s 


y 


JNF y f k , b, s 



If the OD is not set, jump to Y. 
JUMP NOT EQUAL 



3l|SO|l»|2«|27|2« 


2»|24|23|22|2I 


20 


I»|it|l7 


It 


I9|l4|l3 






53 


01 





b 


i 


s 


y 



JNE y,k f b t s 



If the CD is set to not equal, jump to Y. 
JUMP NOT WITHIN LIMITS 



Sl|S0|2t|2»|27|2« 


29|24|23|22|2l 


20 


I«|ll|l7 


19 


I9|l4|l3 








1° 


53 


31 





b 


i 


S 


y 



JNW y,k,b,s 



If the CD is set to outside limits, jump to Y. 
JUMP ODD PARITY 





23~[24|23 


22|2I 


20 


.t|.9|.7 


19 


.9|l«|l3 






50 


a 


1 





b 


i 


s 


y 



JOP a,y,k,b,s 



If the logical product of (A^) and (A g+1 ) contains an odd number of 
binary ones, jump to Y. 



JUMP OVERFLOW 



3.1SO|2*|28|27|>. 


2»|24|23|22|2I 


20 


It|l9|l7 


19 


I9jl4jl3 




50 


04 





b 


i 


s 


y 



JOF y f k f b,s 



If the OD is set, clear OD, jump to Y. 
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JUMP SY + B 



Sl|SO|l«|2l|tr|2« 




"I 11 


10 


It|n|l7 




IS|l4|lS 






n 


2 





b 


i 


s 


y 

, ... ..„._ ,j 



JS s.y.k.b 



Jump to Y, where Y in this case is defined as the address formed by 
the 16-bit sy-field and indexed by (B^)^^. Tne base register 
designator, (B^) ^ ^ f is transferred to ^. An example of 

usage of this instruction is as an exit from a subroutine entered 
through the LOAD B AND JUMP instruction. 



JUMP WITHIN LIMITS 



3l|SO|tt|2«|*7|2« 


29|i4|29|22|2l 


20 


.•|.«|.r 


i« 


is|l«|l5 




53 


35 
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i 


s 


y 



JW y,k,b f s 



If the CD is within limits, jump to Y. 
LOAD B AND JUMP 



S.|»0|2t|2t|2T|2« 


2S|2«|2» 


22j2l 


20 


'•hi 17 




>»Il4|lS 


>2|M|.0|»|||7|«|»|4|S|2|||0 


LB J a,y,k f b f s 


52 


a 








b 


i 


s 


y 



The a sub-field specifies an index register. Load B with the 
contents of P (address of NI).P 19 _ n - B a - Bg l5 _ Q . 

Jump to Y. If B = B , no address is saved and an unconditional jump to Y occurs, 
a o 



RETURN JUMP 



3l|SO|2»|2t|27|2« 


29|24|2S|22|2I 


20 


It|(«|l7 


it 


I»|l*|l5 




53 


02 





b 


i 


s 


y - 



RJ y,k , b,s 



P, (address of NI) - Y. Jump to Y+l. 



11-12-55 



RETURN JUMP CONDITIONAL SETTING 



SI |30]2«|2i]27|2< 




22]2i 


20 


'•M ,T 




15|l4jl5 


I2|>l|<0|»|«|7 |.|5|4| 3|2| 




53 


a 


.2 





b 


i 


s 


y 



If the value of the a sub-field (1,2, or 3) corresponds to a manual 
switch which has been selected, then execute the Return Jump, 
(see RETURN JUMP instruction). 



SPECIAL FUNCTION 
a- VALUE PERFORMED 

1 Return jump if switch 1 is selected, 

2 Return jump if switch 2 is selected. 

3 Return jump if switch 3 is selected. 



RETURN JUMP CONDITIONAL STOP SETTING (PI) 



S.|»0|2»|2.|27|2« 


"1**1" 


22]2I 


20 


I»|lt|l7 


l« 


IS ( 14 J 1 3 




53 
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s 


y 



If the value of the a sub-field (4,5,6,7) corresponds to a manual 
switch which has been selected, then stop before executing the 
Return Jump (see RETURN JUMP instruction). 



SPECIAL 
a-VALUE 

4 

5 
6 
7 



FUNCTION 
PERFORMED 

Always stop before execution of 
Return Jump. 

Stop if switch 5 is selected, 
Return Jump. 

Stop if switch 6 is selected, 
Return Jump. 

Stop if switch 7 is selected, 
Return Jump. 
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12.1.4 instructions Involving Comparison Operations 

All the instructions in this group set the compare designator according to 
conditions indicated. They are usually followed by one of the jump instructions 
which act upon the condition of the compare designator. 



3.| 9 0|2«|2t|*r|„ 


n\z*\zi 


22|2l|>0 


It|ll|l7 




l9|l4|lS 




44 


a 


k 


b 


i 


s 


y 



C a,y,k,b,s 



(A ) : Y; set CD 
a ~~ 

Compare (A ) with Y, and set the CD to 
a ~ 

Equal, if (A g ) ■= Y 

Unequal, if (A g ) t Y 

Greater than or equal, if (A ) * Y 

a 

Less than, if (A ) < Y 

a 



COMPARE, REGISTER 



.3|.«|.3|I2|H|.0 


• |.|T 









74 


a 


4 


b 


i 



HC a,b 



(A ) : (A.); set CD 
a b 



Compare (A ) with (A. ), and set the CD to: 
a b 

Equal, if (A g ) .=. (A fe ) 

Unequal, if (A g ) t (P^) 

Greater than or equal, if (A g ) ^ 

Less than, if (A ) < (A. ) 

a d 
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COMPARE B WITH B 
b a 



ls|l«]lS])2jll|lO 


• |.|T 




.|.|. 
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a 


7 


b 


i 



HCB a f b 



(B ) : (B ); set CD 
b a 

Compare (B.) with (B ) , and set the CD to 
b a 

Equal, if (B g ) = (B b ) 

Unequal, if (B g ) t (B b ) 

Greater than or equal if (B, ) * (B ) 
M b a 

Less than, if (B.) < (B ) 
b a 



COMPARE BIT TO ZERO 



SI |so|2»|2i|27|2« 




22|2I [20 


It|lt|l7 


it 


I3|l4|.» 


.2|..l.O|.|t!7|«|5|4|3|2|.|0 


42 
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y 



BC ak f y,b,s 



(Y) , : 0; set CD 
ak 

Not character addressable. 



The ak-designator specifies the bit of (Y) to be compared to zero where 
* ak £ 31. 

Test the bit specified by the ak-designator; then set the CD to: 

Equal, if (Y) '.= 
a k 

Not equal, if (Y) f 
ak 



COMPARE GATED 



3lj90|29|2«|27|2« 




22(21(20 


.»|.»|.7 


i« 


IS( 14 [ IS 


.2|.l|.0|t|t]7|«|»|4| 9 |2|.|0 


47 
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b 
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s 


y 



CG a t y t k t b f s 



I* - <VI : (A a+1 ); set CD 

Compare the absolute value of Y - (A ) with (A and set the CD to: 

~~ a ■ a+1 

Equal, if I Y - (A g )| = (A fi+1 ) 

Unequal, if | Y - (A g )| t (A a+J ) 

Greater than or equal, if | Y - (A g )| * (A a +i* 

Less than, if | Y - (A g ) | < (A g+1 ) 
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COMPARE INDEX, INCREMENT 



□□ffiEDffiEDmmEEmaEiDDiDiDrnmiaciDEDDanoDnona 


43 
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b 


i 


s 


y 



CXI a t y t k,b,s 



If (B ) * Y, -B and set CD outside limits; 
a _ a 

If (B ) < Y, (B ) + 1 - B and set CD within limits, 
a — a a 

a - equals B register designator. 

Set the CD for outside limits and clears B if (B ) £ Y. Otherwise, 

a a ~ 

increment (B ) by one and set the CD for within limits, 
a 



COMPARE LIMITS 



Sl|90(t»|ll|t7|2« 


>S|2«|tS 


22|Zl|20 


i»jii|i7 


it 


IS||4|.S 




45 


a 


k 


b 


i 


.s 


y 



CL a,y,k,b,s 



(A g ), (A ) : Y; set CD 



Compare (A ) and (A , _ ) with Y. Set the CD to: 
a a+1 — 

Within limits, if (A ..) > Y ^ (A ) 

a+1 - a 

Outside limits, if Y < (A ) or Y ^ U . , ) 

a - a + l 



COMPARE LIMITS, REGISTER 



iniDEEniEona 


□□□□□□□ 
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a 
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b 


i 



HCL a,b 



(A , . ) f (A ) : (A.)-; set CD 
a+1 -a b 



Compare (A ) and (A , _ ) to (A, ) and set the CD to: 
r a a+1 b 

Within limits, if (A ) > (A. ) (A ) 
• a+1 b a 



Outside limits, if (A ) ^ (A. ) or (A u ) < (A ) 

a+1 b b a 
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COMPARE MASKED 



3lj30|Zti*l|27|*« 


25|24[25 


Z2|2l |20 


lt|li[lT 


IS 


I9|l4|l9 




46 


a 


k 


b 


i 


S 


y 



CM a,y t k,b,s 



(A 



a+1 ) : (A a ) O Y; set CD 

Compare the logical product of (A ) and Y with (A ,,) and set the CD to 

a — a+1 

Equal, if (A g+1 ) = (A g ) O Y 

Unequal, if (A g+1 ) t (A g ) O Y 

Greater than or equal, if (A +1 ) * (A g ) © Y 

Less than, if (A g+1 ) < (A g ) Y 

COMPARE MASKED, REGISTER 



.3|.«|.*|.2|Hl.O 


.|.|r 


• |.|« 







74 


a 


6 


b 


i 



HCM a,b 



(A ^) © (A ) : (A, ); set CD 
a+1 a b 



Compare the logical product of (A ) and (A . . ) with (A ) and set the 
CD to: a a+1 b 



Equal, if (A a+1 ) <A fl ) = A fe 

Unequal, if (A g+1 > 0(A g ) ? A b 

Greater than or equal, if (A g+1 ) (A g ) ^ A b 

Less than, if (A j) O (A g ) < A fe 
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DOUBLE COMPARE 



3i|3o|it|2»|ar|*« 


25{2«|t3 


22|2l]20 


.•|.l|.T 




, 5 |i«|ij 


I2|>l]l0|«]t|?|«|s{4|s|2|ll0 


05 


a 


3 


b 


i 


s 


y 



DC a,y,b,s 



(A , A ) : (Y + 1 , Y) ; set CD 
a+1 a 



Not character addressable. 
Not repeatable. 

Compare the content of the double length register (formed with the least 
significant half in A a and the most significant half in A fl+1 ) with the 
content of the double length memory word (formed with (Y) as the least 
significant half and (Y + 1) as the most significant half), and set the 
CD to: 

Equal, if (A +1 , A ) = (Y + 1, Y) 

Unequal, if (A , A ) ^ (Y + 1 , Y) 
a+1 a 

Greater than or equal, if (A , A ) ^ (Y + 1 , Y) 

a+1 a 



Less than, if (A , , , A ) < (Y + 1 , Y) 
a+1 a ' 
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12.4.5 Instructions Involving Logical Operations 

The following instructions perform a variety of logical operations involving 
register and memory: 

ADD LOGICAL PRODUCT 



3l]90|2«|Zt|tr|2« 


2S|24|23 


22|2,|20 




it 


IS||4[|3 




01 


a 


4 


b 


i 


s 


y 



ALP a , y , b , s 



(A a+1 ) + VO (A,) - A a+1 ; (A a ). = (A a ) f 



Add to (A g+ j) the logical product of (A^) and Y and store the result A g+ ^ 



AND 



.»|U|.5|.2|..|.0 


.|.|. 


• |.|« 


.|.|. 





71 


a 


5 


b 


i 



HAND a f b 



(A g ) (A fa ) -. A, 



Form the logical product of (A ) and (A, ) and store the result in A . 

a b a 

^ A b^i = ^ A b^f* Lo 9 ical product or logical AND is defined by the following: 




EXCLUSIVE OR (SELECTIVE COMPLEMENT A) 



Sl|SO|2t|2t|27|2« 


2S|>«|2» 


22[2l|20 


.t|.t|.7 


14 


IS|l4|lS 




01 


a 


3 


b 


i 


s 


y 



XOR a,y,b,s 



I © (A a ) - A a 

Complement the individual bits in A corresponding to the ones in Y, 

a 

leaving the remaining bits in A unaltered. The result is stored in A . 

a a 
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EXCLUSIVE OR A 



I3|i«|is|i2|ii|i0 


• |.|r 




,| 2 |. 





71 


a 


3 


1) 


i 
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HXOR a f b 



(A a ) © (A b ) - A a 

Form the loqical difference between (A ) and (A). The result is stored 
* ■ a b 

in A . Logical difference, exclusive OR v or selective complement is 

a 

defined by the following: 











A a 







1 


















1 


1 




1 






INCLUSIVE OR (SELECTIVE SET A) 



3l|SO|29|2«|27|2t 


"1**1" 


22|2l]20 


It|lt|l7 


It 


I9|l4|l» 


.2|.l|.0|t|t|7|»|5|«|3|2|.|0 


01 


a 





b 


i 


s 


y 



OR a t y f b t s 



Y (A ) - A 

— a a 



Set the individual bits of A corresponding to ones in Y 9 leaving the 

remaining bits in A unaltered. The result is stored in A . 

a a 



11-12-63 



M-5035 
Change 1 



INCLUSIVE OR A 



.5|.4|.3|.2l..|.0 






»<|t|. 





71 


a 


o 


b 


i 



HOR a,b 



(A ) $ (A.) - A 

a D . a ■ 

Form the logical sum of (A ) and (A, ). The result is stored in A 

a b a 

^ A bV~ ^ A bV^ 9 ^ D and 3+1 ^ b. Logical sum, inclusive OR, or 
selective set is defined by the following:' 









A \ 





1 


a X 










1 


1 


1 


1 



LOAD LOGICAL PRODUCT IN Ajj 



3l|SO|2*|2*|27|26 




22|2l|20 


I»|n|l7 




I3|l«]l3 








1° 


01 


a 


5 


b 


i 


s 


y 



LLP a,y,b,s 



Y O (A ) -* A 

- a a 



Form the logical product of (A g ) and Y. The result is stored in A 
LOAD LOGICAL PRODUCT IN A a+i 



Jl|SO|2»|2»|*7|t« 


29|24|2S 




'•hi 17 


i« 


.»|.4|« 


l2|M|lO|* 


•Mv 


• M»M 


1° 




01 


a 


7 


b 


i 


s 


y 


LLPN 



Y © (A a ) - A >+1 ; (A,) i = (A,) f 

Form the logical product of (A ) and Y. The result i s stored in A 

a 

(A g ) is unchanged. 
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REPLACE A - LOGICAL PRODUCT 



Sl|S0|Z9[ll|27|t« 


29|2«|23 


22|ZI |20 


.•|.»|.r 


it 


I5jl«|l5 


l2)M|.0|t|t(7|«|5|4|3|2|.|0 


n:i 


P 


() 


b 


i 


s 


y 
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KNLP si.y.b.s 



(A a+1 ) - Y O (A a ) - Y and A a+1 ; = (A g ) f 

Subtract from (A g+1 ) the logical product of Y and (A g ), then store the 

result i n Y and A . 

a+1 

REPLACE A + LOGICAL PRODUCT 



31 |)0|29|2t|27|2« 


29|2«|23 


22|2l|20 


l»|.t|.7 






• 2|M|lO|t|t|7|t|s|4(3|2|l (0 


03 


a 


4 


b 


i 


s 


y 




i o 


<V 




Y and (A ^ ); (A ,). = (A ) 
a+1 a i a 


Add 


to (A 


a+l )f 


the 


logical 


product of Y and (A ) 
~ a 


in Y 


and 


A . 

a+1 










REPLACE EXCLUSIVE OR 


(REPLACE SELECTIVE COMPLEMENT) 


3l(SO|29|2e|27 26 


2S|2.|23 


22|2l|20 


I»|tljl7 




I3|l4|l3 


l2|ll|lO|t|«|T|t|»l4|3(2[l [0 


03 


a 


3 


b 


i 


s 


y 


Y $ 


(A ) 
a 


- Y 


and 


A 

a 







RALP a,y,b,s 



RXOR a f y,b,s 



Not character addressable. 

Complement the individual bits in A a corresponding to ones in Y, leaving 

the remaining bits in A unaltered. The result is stored in A and Y 

a a 



REPLACE INCLUSIVE OR (REPLACE SELECTIVE SET) 



3l|SO|2»|2i|27|2t 


2fl|24|23 


22|2l|20 


It|li|l7 


it 


is] 14 [ IS 




03 


a 





b 


i 


s 


y 


Y $ 


(A ) 
a 


- Y 


and A 

a 







ROR a, y t b t s 



Set the individual bits in A g corresponding to ones in Y, leaving the 

remaining bits in A unaltered. The result is stored in A and Y. 

a a 
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REPLACE LOGICAL PRODUCT 



3i|50}29|2«|27]2« 


2S]2«|23 


22(2 l|20 


I»|li(l7 


it 


, 9 |.«|l3 


.2|.l|.0|»| a |7|«| 9 |4] S |2|.|0 




03 


n 


5 


b 


i 


s 


y 


RLP a f y,b,s 


Y 


(A ) 
a 


- Y 


and 


a+1 






Load 


A -n 

a+1 


wi th 


the 


logical 


product of Y and (A^' 


1; then store the result 



at Y. 

REPLACE SELECTIVE SUBSTITUTE A 



J.|>0|2»|2 # |27|26 


23|24|23 


22(21 120 


..|..|.7 


it 


. 9 |.4|. S 


.2|M|.O|t(l|7|«|3|4|3|2|.(0 


03 


a 


2 


b 


i 


s 


y 



RMS a f y,b,s 



For (A ) =1, (Y) - (A - Y; (A ). = (A ), 

an - n a+1 f a i a f 



For each bit, n ( which is equal to one in A , .substitute the nth bit of 

a 

Y for the nth bit of the A ... The result in A is stored at Y. 
- a+1 a+1 

REPLACE SELECTIVE CLEAR 



3l|30j2«|2«|27|2e 


2S(24]23 


22(21(20 


It]ll(l7 


IS 


13(14(13 


.2|..|.0(t(.|7|«(3|4|3|2|.|0 


03 


a 


1 


b 


i 


s 


y 



RSC a t y t b,s 



(A ) O Y' -* Y and A 
a - a 

Clear the individual bits in A corresponding to ones in Y t leaving the 

remaininq bits in A unaltered. The result is stored in A and 4. 
* a a 



SELECTIVE CLEAR A 



3l|SO|2»|2«(27(2« 


23(24(23 


22|2.|20 


lt|. a |.7 


It 


. 9 |<4|.3 


l2|M|.0|t|t|7|.|3(4(3|2|.|0 


01 


a 


1 


b 


i 


s 


y 



SC a, y,b t s 



(A ) O Y' ~* A 

a — a 

Form the logical product of (A ) and the complement of Y, The result is 

a 

stored in A . Selective clear is defined by the following: 
a 





A 

n 






Y 

— n 







1 










1 


1 











11-12-66 



M-5035 
Change 1 



SKLKCTfVK SlIBSTTTUTK 



Ji|j0|2»llljl7|2i 




2 2 | 2 .|lO 


.♦|. a |.T 




is|i«|is 


..|..|..|.|.|,|.|.|.|.|.|.|. 


01 




2 


b 


i 


s 


y 



MS a,y,b,s 



For (A ) = 1, Y (A , . ) ; (A ). = (A ). 
an -n a+1 n a i a f 

For each bit, n, which is equal to one in A , substitute the nth bit of Y 
for the nth bit of A 

a+1 

STORE LOGICAL PRODUCT 



ra [232223 22 ED EE EE 


23 


22]ZI [20 


i9jn|ir 


it 


■5|l4|,3 


■»1"M»1«M»I»M >l»l 1 1° 


02 


n 


4 


b 


i 


s 


y 



SLP a t y,b,3 



(A a ) (A a+1 ) -Y; (A,) i = (A a ) f; (A a+1 ) i = (A, +1 ) f 



Store at Y the logical product of (J\^) and (A g+1 ). The contents of the 
A-registers are unchanged. 

SUBTRACT LOGICAL PRODUCT 



NLP a t y f b,s 



□□cmammEEEEEaEDDDaiDiDnEiDaiEaQnnanDODQ 


01 


a 


6 


b 


i 


s 


y 



(A a+1 > - Y © <A a > - A a+1 ; (A g ). = (A a ) f 

Subtract from the logical product of (A g ) and Y. The result is 



stored in A 



a+1* 
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12.4.6 Shift Instructions 



DOUBLE SHIFT LEFT CIRCULARLY 



IS| f 4 j IS 1 12| 1 1 ( 10 




•|5|4|3|2|.|0 


63 


a 


m 


63 


a 


1 








b 





63 


a 


1 


1 





b 






HDLC a,m 
HDLC a,b,l 

HDLC a,b,2 



normal shift count 
shift count in 
shift count in A, 



Shift the content of the double length register (formed with (A g ) as the 
least significant half and (A g ') as the most significant half) to the 
left circularly, where the shift count is specified by the m-field. 

DOUBLE SHIFT RIGHT FILL SIGN 



is|l«|l3|l2|ll|lO 


• |.|r 


• |9]4| 3 | 2 | • |0 


67 


a. 


m 


67 


a 


1 








b 





67 


a 


1 


1 





b 






HDRS a,m 



HDRS a,b,l 1 : shift count in Bj^ 
2 : shift count in A 

HDRS a,b,2 



normal shift count 

b 
b 



Shift the content of the double length register (formed with (A ) as the 

a 

least significant half and as the most significant half) to the 

right m places, end-off with sign fill on the left. The maximum allowable 
shift count is 2 6 -l = 63. 



DOUBLE SHIFT RIGHT FILL ZEROS 



□□□EmiDaDnQoanana 



65 




m 


HDRZ 


a t m 


65 


a 


] 








b 





HDRZ 


a t b f 1 


65 


a 


1 


1 





b 





HDRZ 


a,b,2 



m : normal shift count 

1 : shift count in B^ 

2 : shift count in A, 



Shift the content of the double length register (formed with (A ) as the 

a 

least significant half and (A g+ j) as the most significant half) to the 

right, end-off and fill with zeros on the left, where the shift count is 
specified by the m-field. The maximum allowable shift is 2^-1 ■= 63. 
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SHIFT LEFT CIRCULARLY 



I9[i«|ll|u|ll|l0 






62 


a 


m 


62 


a 


1 








b 





62 


a 


1 


1 





b 






HLC a,m 

m 

HLC a,b,l * 
HLC a,b,2 



normal shift count 
shift count in 
shift count in A,. 



Shift (A ) left circularly where the shift count is specified by the 
a 

m-f ield. 
SHIFT RIGHT FILL SIGN 



I3|l4|is[l2|il|l0 










I'M' 






66 


a 


m 


HRS a t m 


66 


a 


1 





U 


b 





HRS a t b,l 


66 


a 


1 


1 





b 





HRS a t b f 2 



m : normal shift count 

1 : shift count in 

2 : shift count in A, 



Shift (A g ) to the right, end-off with sign fill on the left, where the 
shift count is specified by the m-field. The maximum allowable shift is 
2 6 -l = 63. 

Example of right shift, sign fill P^' m ~ 9. 
(A 2>i 



aioooi i i i i ioooooi i i i iooi i loooi i i i 



m i m_i«ooo 1 1 1 1 1 1 ooooo 1 1 1 1 1001 
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SHIFT RIGHT FILL ZEROS 



. 9 |.4|. 9 |. 2 |..|.0 


.|.|T 


.|.M.|.|.|. 


64 


a 


m 


64 


a 


1 








b 





64 


a 


1 


1 





b 






HRZ a,m 

HRZ a.b.l 
HRZ a f b,2 



normal shift count 
shift count in 
shift count in A^ 



Shift (A ) to the right, end-off and fill with zeros on the left, where 
a 

the shift count is specified by the m-field. The maximum allowable shift 
is 2 6 -l =63. 

Example of right shift Agi m = 9. 



(A 2 ). 



(A 2 ) f 



• £000 1 1111 1000001 1 1 1 1001 1 10001 1 1 1 

\t^rx * ^ 

ipOOOOpppp.i'OOOl 1111 1000001 1 1 1 1001 



11-12-70 



12.4.7 Instructions Referencing Control Memory 



M-5035 



There are eight instructions referencing control memory; four are Format I 
full-word instructions, and the other four are half-word instructions, Format 
IV-A. The instructions which refer to the interrupt set of registers are 
all privileged instructions (PI) while the other instructions are privileged 
for certain control memory address reference. 



LOAD INTERRUPT CMR (PI) 



Sl|30|29|2a|27|z« 


»M»I"I"1 20 


'•I'M' 7 


14 


I9|l«[is(l2 


..M.|.|r|.|.|.|.|<|.|. 


55 


ak 


b 


i 


S 


y 



Y - CMR 



The a-designator and k-designator form a six-bit (central processor) 
control memory address (100-177)^ of the interrupt mode registers as 
follows . 



EFFECTIVE ADDRESS 



HARDWARE 
ASSIGNED 



ak -VALUE 



1 
1 
♦ 

1 
1 
1 
♦ 

1 
1 
1 



00 
01 

* 

26 
27 
30 

♦ 

75 
76 
77 



CONTROL MEMORY REGI STER 



CMR address 100 
CMR address 101 

CMR addriss 126 
CMR address 127 



(A ) 
(Ap 



(SJ 
<S*>. 

CMR address 130 (unassigned) 

CMR address 175 (SIR.) 
CMR address 176 (SIR?) 
CMR address 177 (SIR^) 



Load the CMR address (specified by the special ak-value) with Y. 



NOTE 



In the repeat mode, ak + 1 - ak. This instruction 
is not interruptable in the repeat mode. 
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LOAD INTERRUPT CMR WITH A (PI) 



)9| i« { 1 3 1 1 2| 1 1 ( 10 


»|.|r|.|.|4 


s|>|. 





61 


3f 4 


b 


i 



HLCI 



af.b 
4 



(A u ) - CMR 
b 



b specifies an accumulator register; 
i (bit or 16) = 1 



The a-designator and k-designator form a six-bit address in (central 
processor) control memory in conjunction with the i-designator to access 
control memory locations as follows: 



1 



af 4 VALUE 



00 
01 

I 

26 
27 
30 
I 

75 
76 
77 



CONTROL MEMORY REGISTER 



CMR address 100 (A Q ) 
CMR address 101 (A^ 



CMR address 126 (S, ) 
CMR address 127 (S^) 
CMR address 130 (unassigned) 



CMR address 175 (SIR.) 
CMR address 176 (SIR^) 
CMR address 177 (SIR^) 



Load the CMR address specified by the af 4 -designator with (A^), 
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LOAD TASK CMR 



Sl|)0|2«]2l|2f|2« 


2S|24|2j|22|2l|20 


.»|..|.r 


it 


\$\ l*| IS 


. 2 |.l|l0|»|tjr|.|»|4|»|2|.|0 


54 


ak 


b 


i 


s 


y 



LCT a k , y , b , s 



Y - CMR 

The a-designator and k-designator form a six-bit (central processor) 
control memory address (0-77^) of the task mode registers as follows 

The a-designator and k-designator form a six-bit (central processor) 
control memory address (0-77^) of the task mode registers as follows: 



a k- VALUE 

00 
01 

* 

26 
27 
30 

t 

57 

6X 
7X 



CONTROL MEMORY REGISTER 



CMR address (A n ) 
CMR address 1 (A:) 

I 1 

CMR address 26 (S, )* 
CMR address 27 (S^)* 
CMR address 30 (unassigned) 

CMR address 57 (unassigned) 

Breakpoint* 

Active status 



Load the CMR address (specified by the special ak-value) with Y. 

NOTE 

In the repeat mode t ak + 1 -» ak. This instruction is 
not interruptable in the repeat mode. 

This instruction is privileged when repeated. 



* Addresses 60-77 8 and 20-27 fl are addressable in the interrupt mode 
only. 



m 
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LOAD TASK CMR WITH A 



IS 1 1« f 1 3 1 1 2] 1 1 1 10 


• |.|t1..|.-|« 


.|.|. 





61 


af 4 


b 


i 



HLCT af 4 ,b 



(A ) - CMR 
b 

b specifies an accumulator register 
i (bit or 16) =. 

The a -designator and f^- designator form a six-bit (central processor) 
control memory in conjunction with the i-designator to access control 
memory locations as shown below. 



i = 



SPECIAL 

Af. VALUE 
4 



CONTROL MEMORY REGISTER 



00 
01 

26 
27 
30 

56 
57 
6X 

7X 



CMR address (A n ) 
CMR address 1 (A:) 

CMR address 26 (S, ) 
CMR address 27 (s!j) 
CMR address 30 (unassigned) 



CMR addresses 
20-27 access- 
ible in inter- 
rupt mode only 



1 



CMR address 56 (unassigned) 
CMR address 57 (unassigned) 
Breakpoint (accessible in interrupt 
mode only) 

Active status (accessible in inter- 
rupt mode only) 



Load the CMR address specified by the af^-designator with (A^.). 
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STORK INTERRUPT CMR (PI) 



si|jo|m|h|it|2» 


29|24|t)|22]2l|lO 


.t|..|.r 




. 9 |i«|.S 


•a|"|.o|.|i|r|.| 9 |4|3|i|.|o 


57 


nk 


1) 


i 


s 


y 



SCI ak,y,b,s 



(CMR) - Y 

The a -designator and k-designator form a six-bit (central processor) 
control memory address (100 through 177> 8 of the interrupt mode registers 
as f ol lows : 



EFFECTIVE 


ADDRESS 


— r~ 

HARDWARE ! 




ASSIGNED ; 


a k -VALUE 


1 1 


00 


i i 


I 


i : 


26 


i i 


27 


i i 

i i 


30 

\ 


i : 


75 


1 S 


76 




77 



CONTROL MEMORY REGISTER 



CMR address 100 (A~) 
CMR address 100 (Ap 



CMR address 126 (S,) 
CMR address 127 (Sp 
CMR address 130 (unassigned) 

CMR address 175 (SIR.) 
CMR address 176 (SIR^) 
CMR address 177 (SIR°) 

Store the content of the CMR address (specified by the ak-value) at Y. 

NOTE 

In the repeat mode, ak + 1 -* ak. This instruction 
is not interruptable in the repeat mode. 



11-12-75 



M-5035 
Change 1 

STORE INTERRUPT CMR IN A (PI) 



. 9 |,4|. 3 |. 2 |.l|,0 




s|a|. 





60 


sf 4 


b 


i 



HSCI af 4 ,b 



(CMR) - A, 



b specifies an accumulator register; j i (bit or 16) = 1 ' 

The a-designator and the f^-designetor form a six-bit (centre! processor) 

control memory address in conjunction with the i-designator to access 
control memory locations as follows: 



i = 1 si . VALUE 
4 



00 
01 

J 

26 
27 
30 

* 

75 
76 
77 



Load A with (CMR . ) 
b af 4 



CONTROL MEMORY REGISTER 



CMR 


address 


100 


CMR 


address 


101 


CMR 


address 


126 


CMR 


address 


127 


CMR 


address 


130 


CMR 


~l 


175 


CMR 


address 


176 


CMR 


address 


177 
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STORK TASK CMR 



j7fso|2»jii|2rj»6 


29j»4)23|l2[zi jlO 


t*|il|ir 


it 


, 9 |.«|,s 


.2|M|.0|.].]r|.|>|4|)]2|.|0 


56 


ak 


b 


i 


s 


y 



SCT ak,y f b,s 



(CMR) - Y 



The a-designator and k-designator ^orm a six-bit (central processor) 
control memory address (0 through 77) fi of the task mode registers as 
follows r 



a k- VALUE 

00 
01 
I 

26 
27 
30 

* 

57 
6X 

7X 



CONTROL MEMORY REGISTER 

CMR address (A n ) rruD AA 

CMR address 1 (A?) f C ™ ""dresses 20 ~ 21 
I 1 < addressable in 

CMR address 26 <S A ) l*" 16 ™^ mode onl y 

CMR address 27 (S^) 

CMR address 30 (unassigned) 

CMR address 57 (unassigned) 
Breakpoint (accessible in inter- 
rupt mode only) 

Activate status (accessible in inter- 
rupt mode only) 



Store the content of the OMR address (specified by the ak-value) at Y. 

" •* NOTE 



In the repea-fc '.moTj£ ak + 1 - ak. This instruc- 
# « tij^n i* not 'interrupt able in the repeat mode. 

^This, instructiroja"'T5 privleged when repeated. 
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STORE TASK CMR IN A 





1.0 


• l.kM.I* 







60 




b 


i 









HSCT af 4 ,b 



(CMR) -A 



b specifies an accumulator register; 
i (bit or 16; =0 

The a-designator and f ^-designator form a six-bit (central processor) 
control memory address in conjunction with the i -designator to access 
control memory location as follows: 



i ■ = af 4 VALUE 

00 
01 

26 
27 
30 

I 

56 
57 
6X 

7X 



Load A. with (CMR „ ) 
b af 4 



CONTROL MEMORY REGISTER 

CMR address (A ) 

CMR address 1 (A^) j CMR addresses 20-27 

I \ addressable in 

CMR address 26 (S,) L interrupt mode only 

CMR address 27 (s£) ' 

CMR address 30 (unassigned) 

\ 

CMR address 56 (unassigned) 

CMR address 57 (unassigned) 

Brea*kgoint (accessible in interrupt mode 

only-)* 

Active status (accessible in interrupt 
mode "only f *. * . m 



11-12-78 
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12.4.8 Interrupt Handling Instructions 

These are all privileged instructions, and none are character addressable or 
repeatable. 

ALLOW CLASS III INTERRUPTS (PI) 



is|l«|l3|l2|ll[lO 


• |.|T 


• H« 


.|.|. 





77 





5 









Release the lockout for input/output Class III interrupts. This shall 
not affect the individual channel interrupts enable/disable logic as set 
by AEI and PEI instructions. 
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ALLOW ENABLE INTERRUPT (PI) 



3l|30|29|2»|27|26 


2S|24|23 


22|2l[20 


M>|..|.7 


It 


Is|l4|l3|l2|ll|l0|9 | S|r|t[»|4|3|2|l|0 


07 


a 


1 


b 


i 





AEI a,sy e b 



The a -designator specifies which IOC will receive the enable interrupt 
information: 



SPECIAL 
a-VALUE 






IOC TO RECEIVE ENABLE 
INTERRUPT INFORMATION 





IOC 


#0 


receives 


enable 


interrupt 


1 


IOC 


*l 


receives 


enable 


interrupt 


2 


IOC 


*2 


receives 


enable 


interrupt 


3 


IOC 


*3 


receives 


enable 


interrupt 


4-7 


Not 


use 


id 





The s-designator in conjunction with the y-operand forms a 16-bit sy- 
field. The 16-bit sy-field enables interrupts on a channel basis in the 
specified IOC as follows: 





SPECIAL 




FUNCTION PERFORMED 




sy-VALUE 




AT SPECIFIED IOC 


sy 


(bit 0) = J 




Enable channel 


sy 


(bit 1) = ] 




Enable channel 1 


sy 


(bit 2) = J 




Enable channel 2 


sy 


(bit 3) = ] 




Enable channel 3 


sy 


(bit 4) = ] 




Enable channel 4 


sy 


(bit 5) = 1 




Enable channel 5 


sy 


(bit 6) = J 




Enable channel 6 


sy 


(bit 7) = ] 




Enable channel 7 


sy 


(bit 8) = ] 




Enable channel 8 


sy 


(bit 9) = 1 




Enable channel 9 


sy 


(bit 10) = 


1 


Enable channel 10 


sy 


(bit 11) = 


1 


Enable channel 11 


sy 


(bit 12) = 


1 


Enable channel 12 


sy 


(bit 13) = 


1 


Enable channel 13 


sy 


(bit 14) = 


1 


Enable channel 14 


sy 


(bit 15) = 


1 


Enable channel 15 



Enable the interrupt request for each IOC channel specified in the 16-bit 
sy-field. 
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INTERPROCESSOR INTERRUPT (PI) 



Sl]S0|2«|2*f2 7[2« 


2S[2«|23 


22]2l|20 


i»|i»|ir 


it 


.5|.4|.3|.2|..|.O|t|t|7|t|»|4|3| 2 |.|0 


07 


1 





b 


i 


sy 



A class II interrupt is generated for each processor selected by the sy- 
field after B b modification. The processor number is bit-encoded in the 
lower 18 bits of sy + as follows: 

16-bit result of sy + (B^)^^- 



15 


14 8 


7 


6 


5 


4 


3 


2 


1 







Not used 
















Interrupt Processor No. 


Interrupt Processor No. 1 


Interrupt Processor No. 2 






Interrupt Processor No. 3 


Self interrupt 
control bit 


Interrupt Processor No. 4 


Interrupt Processor No. 5 


Interrupt Processor No. 6 


Interrupt Processor No. 7 



This instruction interrupts all processors whose corresponding bit is set 
as indicated above. If bit 15 is set, and if the processor executing 
this instruction is selected to be interrupted, then the processor ex- 
ecuting the instruction will ignore the interrupt. If bit 15 is clear 
and the processor executing the instruction is selected to be interrupted, 
then the interrupt request will occur. 
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INTERRUPT RETURN (PI) 



3l|30]29|2«|27|26 


29[24(23 


22|2l|20 


.•|.«|.r 


Ift 


19 1 1« 1 1 3 1 1 2 


"|'0|.|i|7|«|3|4|3|2|.|0 


07 





5 















Return control to the processor state designated by the DSW corresponding 
to the state control field in the active status register. 

PREVENT CLASS III INTERRUPTS (PI) 



id] l«l 19 1 12| 1 1 ] 10 


.|,|T 




3|2|, 





77 





4 









Lock out the input/output class III interrupts. The interrupts are held 
pending until this lockout is removed. 

PREVENT ENABLE INTERRUPT (PI) 



3l|30|29|2S|27|26 


29|2«|23 


22[2l|20 


.9|. S |.7 


l« 


l 9|.4i.3|l2i.l|lO|9|t|7|e|3|4|3|2|l|0 


07 


a 


2 


b 


i 


sy 



The a-designator specifies which IOC will receive the disable interrupt 
information: 



SPECIAL IOC TO RECEIVE DISABLE 

a -VALUES INTERRUPT INFORMATION 

IOC *0 receives disable interrupt 

1 IOC *1 receives disable interrupt 

2 IOC *2 receives disable interrupt 

3 IOC »3 receives disable interrupt 
4_7 Not used 
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The s-designator in conjunction with the y-fieid forms a 16-bit sy-fielck 
The 16-bit sy-field disables interrupts on a channel basis in the speci- 
fied IOC as follows: 



sy- VALUE FUNCTION PERFORMED AT 

sy- VALUE SPECIFIED ION 

sy (bit 0) = 1 Disable channel 

sy (bit 1) = 1 Disable channel 1 



sy (bit 14) = 1 Disable channel 14 

2y (bit 15) = 1 Disable channel 15 



Disable the interrupt request for each IOC channel specified in the 
16-bit sy-field. 

WAIT FOR INTERRUPT (PI) 



,S M IS M"I , ° 


•M' 


.).|« 


>|»|< 





77 





6 





1 



This instruction causes the computer to stop referencing memory until an 
interrupt occurs (any class not currently locked out). After an interrupt 
request is detected, the processor honors the interrupt, saving the 
address of the instruction following the wait for interrupt. Upon return 
from the interrupt, normal processing continues. 
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12.4.9 Miscellaneous Instructions 
CLEAR BIT 



3.|>oi"|*i| 2 r| 2 . 


Z9]2«f23|22|2l |20 


.t|..|.r 




!S|l4jl5 


»|nH.|.|T|.|.|.|.|.|.|. 


32 


ak 


b 


i 


s 


y 



BZ ak,y t b, s 



O - (Y) 



ak 



Not character addressable. 

The ak-designator specifies the bit of (Y) to be cleared, where 
sak ^31. 



3l|SO|29|2a|27|2« 




22[2i|20 


.t|.l|,7 




•l|l4|ll 


.2|u|.0| a | a |7|.|»|4| 9 |2]l|C 


02 


n 





b 


i 


s 


y 



cm- a.y.b, 



Number of "l's" in Y - A 



Count the bits in Y which are set to one and store the count in A 

f 

DOUBLE SCALE FACTOR A 



, 9 |i«|.3|.*|n|.0 


.|.|T 


•hi* 


.|.|. 





70 


a 


i 


b 


i 



HDSF a t b 



Normalize (A A ); normalized shift count -* A,. 

a+1 a n 

Shift the content of the double length register (formed with (A ) as the least 

a 

signficant half and (A ) as the most significant half) to the left circularly 

a.-r-L 



until normalized. The required shift count is stored in A^ If a or a+1 = b, 
the registers shall be normalized with no shift count available. If ( A a+1 > A a ) 
i = or all l's, the resultant shift count is 63. 



11-12-84 



M-5035 
Change 1 



EXECUTE REMOTE 





23 


"l 2, h° 


I9|li|l7 


It 


l9|l«]lS 


'2|"l'0|»|.|7|.| 5 |4|3|2|.|0 







V) 


I) 


i 


s 


y 



XR y,b,s 



Execute instruction at Y; (P) is unchanged. 

Not character addressable. 
Not repeatable. 

Execute the whole-word instruction or two half-word instructions which 
is at Y, without changing (P). 



EXECUTE REMOTE LOWER 



EHESESB3EBS3ESE&ES 


ESSIES 


DiDiflEEOEBncannoaoDDnoa 


02 





3 


b 


i 


s 


y 



XRL y,b,s 



Execute inst ruction at Y^ ; (P) is unchanged. 

Not character addressable. 
Not repeatable. 

Execute. the lower half-ivnrri instruction at Y, without changing (P) 
ENTER EXECUTIVE STATE 



3i |30|29|2a|27]26 


2S|24j?3 


22[2i{2C 


>9|.«|.7 


<« 


4.|,>|..|mH'.|.|,|.|.|.|,|,|,|. 


07 








b 


i 


s y 



XS sy,b 



Interrupt to executive entrance address. 

Not character addressable, 
Not repeatable. 

The s-desiynator and the y-designat or are combined to form a l(>-bit 
sy-field which, after B modification, is used as follows: 

Y Q ■ form the interrupt code word. 

Switch control to the interrupt state and transfer control to the execu- 
tive entrance address as determined by the initial condition word pointer 
associated with the Class IV interrupt state. 
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INITIATE INPUT /OUTPUT (PI) 



3i|SO|2»|2l[27|2« 


»|24|23 


22|2l|20 


1 • 1 1 • 1 1 7 


l« 


is|i«|is 




,o|. 


.1-1.1.1. M.I 




07 


n 


4 


b 


i 


s 


y 


Y - 


IOC 

a 


(Y' = 


y + 


(B u ) + 
b 


(S 

s 


)) 







Not character addressable. * . . 

Not repeat able. 

The a -designator, specifies which IOC will receive the processor command 



IOC to RECEIVE 
COMMAND ADDRESS 

IOC »0 receives address 
IOC *1 receives address 
IOC $2 receives address 
IOC *3 receives adress 
Not used 

Provide the IOC specified by the a-field with the absolute address Y 
(address of the first command in an input/output program sequence). 



as follows; 

SPECIAL 
a -VALUE 


1 
2 
3 
4-7 



r 
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IOC MONITOR CLOCK (PI) 



Si]30]2*]2t]2r|2« 


23|t«|23 


22[2l(20 


I»|lt|l7 




'»|w|'»l'«l»M»|i|M*I»l«l»l«l'|o 


07 


a 


3 


b 


i 


sy 



LIM a,sy,b 



Y -» monitor clock 



Not character addressable. 
Not repeatable. 

The a-designator specifies which IOC monitor clock will be entered with Y: 

IOC MONITOR CLOCK 
a -VALUE TO BE ENTERED WITH Y 

IOC »0 
IOC *1 
IOC *2 
IOC *3 
Not used 

The s-designator and the y-field form a 16-bit sy-field which, after 
B modification, is used to load the IOC monitor clock specified by the 
a-value. 

If the 16-bit sy-field (after B modification) is negative, the monitor 
clock in the specified IOC is disabled; if the 16-bit sy-field (after B 
modification) is equal to zero, the IOC monitor clock (that was entered 
with zero) generates a Class III interrupt in an attempt to interrupt 
any central processor connected to the IOC; otherwise, the IOC monitor 
clock is counted down in the normal manner at the rate of 1,024 counts 
per second. 




1 
2 
3 
4-7 
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REPEAT 





23|2«|23 


22|2 1 [20 


I9|..|l7 


it 


is|i« U 12 II 10 j 9 J 8 7 6 | 5 j * | 3 j 2 | I | 


07 


a 


6 


b 


i 


-*> y 



a,sy,b 



Repeat Nl (B-) times or until rest condition is satisified. 

Not character addressable. 
Not repeat-able.. 

The a-designator controls the repeated instruction termination conditions 
as ' follows : 



a- VALUE 


1 
2 
3 
4 
5 



NON-COMPARE 

INSTRUCTIONS a-VALUE 

Terminate if A £ 

Terminate if A = 1 

Terminate if A ^ 2 

Terminat e if A < 3 

Do not terminate 4 

Terminate if A contains 5 
an even number of binary 
ones. 

Terminate if A contains 6 
an odd number of binary 
ones . 

Do not terminate 7 



COMPARE 
INSTRUCTIONS 

Terminate if CD set to t 

Terminate if CD set to = 

Terminate if CD set to > 

Terminate if CD set to as 

Terminate if CD set to < 

Terminate if CD set to £ 



Terminate if CD set to OL 



Terminate if CD set to WL 



The b-des iyna I or shall specify the use of S on replace instructions as 
follows: 

If b 1 0, and ihe repeated instruction is a replace instruction, the 
operand address of the. replace, instruction is . incremented . by (S^) for 
the store portion of the replace instruction. If b ~ 0, normal 
operation occurs. 

The s-designator and the y-field form a 16-bit constant (including sign) 
which specifies the increment or decrement of the operand address after 
each execution of the repeated instruction. This increment or decrement 
is added to the B-register of the repeated instruction after each execution. 

The instruction shall repent, the next sequential instruction n times, 
where n is contained in IU. If H- is zero, the next sequential 
instruction is skipped. 
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A, above, refers to the accumulator specified in the repeated instruction 
The repeat count is available in which is decremented by 1 after each 
execution. The use of in the instruction being repeated should be 
avoided. 



SCALE FACTOR 



.»|.«|.»].2|n|. 


.|.|T 


•hi 4 


•hl- 





70 


a 







i 



HSF a,b 



Normalize (A g ); normalized shift count - 

Normalize (A g ), and store the shift count in A.. (A ) is shifted left 

o a 

circularly until normalized, the required shift count is then stored 

in A b . If a = b, the accumulator is normalized with no shift count 

available. If (A ) i = 0, the resultant shift count is 63. 
a 



SET BIT 



3i|30|l9|2*|2r]2C 


23|24|23|22|2l]20 


l»|li|lT 




I»|l4]l9 




33 


ak 


b 


i 


s 


y 



BS ak,y,b,s 



1 - (Y) 



ak 



Not character addressable. 

The ak -designator specifies the bit of (Y) to be set where £ ak £ 31 
STOP PROCESSOR (PI) 



I9|l«|l9|l2|il|l0 


.|.|r 


• |.|« 


>|.|. 





77 





6 









HALT 



Terminate processor operation and illuminate the stop indicator light. 
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STORE I/O MONITOR CLOCK (PI) 





,|.|, 


• |.|« 







ji9|i«ji3ji2(n[iO 

1 77 


a 







i 



HSIM a,b 



(IOC monitor clock) - A L 
a b 



The a-designator specifies which IOC monitor clock is to be referenced 
as follows: 



SPECIAL 






a -VALUE 


FUNCTION 


PERFORMED 





(ioc *o) 


Mon. Clk 


1 


(IOC »1) 


Mon. Clk 


2 


(IOC *2) 


Mon. Clk 


3 


(IOC »3) 


Mon. Clk 


4-7 


Not used 





- A 

- ^ 

- A h 

- A b 



Load A fa with the content of the IOC monitor clock selected by the a-desig- 
nator. 
STORE REAL-TIME CLOCK 



I9ji*|u|i2|n|i0 


• |t|T 


.|.|« 







77 


a 


1 


b 


i 



HSTC a,b 



(IOC real-time clock) - A. 
a b 



The a-designator specifies which IOC real-time clock is to be referenced 
as follows : 



SPECIAL 

a- VALUE 


1 

2 
3 
4-7 



FUNCTION PERFORMED 

(IOC »0) RTC - \ 

(IOC »1) RTC - AT 

(IOC #2) RTC - A? 

(IOC »3) RTC - AjJ 



Not used 

Load A^ with the content of the IOC RTC selected by the a-designator. 
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TEST AND SET FLAG 



St|S0|t«|2«|2r|2t 


2S|2«|2S 


22|2l]20 


..|.t|,r 


it 


i9|l«|lJ 


l2|M|.o|t| a |7|«|s|4|)|2|.|0 


0!i 





7 


b 


i 


S 


y 



Set the CD; 1 ~* Y 31 

Not character addressable. 

Set the flag bit in the upper bit of address Y. If this bit was originally 
cleared, set CI) to equal; otherwise, set CD to not equal. 
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1 2 . <\ . 1 Extension Mnemonics 

Extension mnemonics are recognized by the Assembler, but. are not unique hard- 
ware instructions themselves; however, they utilize special configurations 
of hardware instructions or are made available for programmer convenience. 
These instructions fall into three categories: 1) pseudo hardware instruc- 
tions; 2) indirect words; and 3) buffer control words. 

a) Pseudo Hardware Instructions: 
CLEAR A (ZA) 

CLEAR B (ZB) 

HALF-WORD CONSTANT (HK) 

NO OPERATION (Full Word) (NOOP) 

NO OPERATION (Half Word) (HNO) 

STORE ZEROS (SZ) 

b) Indirect Word Instructions: 
INDIRECT WORD (IW) 
INDIRECT WORD CHARACTER (IWC) 
INDIRECT WORD CHARACTER INCREMENT (IWCI) 
INDIRECT WORD, SPECIAL BASE (IWS) 
INDIRECT WORD, SPECIAL INDEX (IWB) 

MEMORY PROTECTION (MP) (Not an instruction) 

c) Buffer Control Word Instructions: 
BUFFER CONTROL WORD (BCW) 
BUFFER CONTROL WORD ESI (BCWE) 
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CLKAH A 



31 30 29 2t|27|2< 


23|2«|23 


22(2 1 (20 




It 


.9|.«|.3|I2 


H|,0|t|t|7|. 3|4|3 2|.|0 


10 




















ZA a 



- A 



a 



a - norma] 



Load A with zeros. All other instruction fields are zeros 
a 



CLKAR B 



3l|30|2»|Sl|27|2« 


2S|2«|23 


22|2I|20 


I»|li|l7 


It 


.S|.«|.3|l2 


••N*|«|TM.|.|>|.|.|e 


20 


a 


















ZB a 



- B 



a - special (specifies B ) 

a 

Load B with zeros. All other instruction fields are zeros 

a 



HALF-WORD CONSTANT 

t9|'«l'»|'2l"i'Ol»i«|7 l*l»M ' jO 



HK e 



This instruction permits programmers to intersperse half-word constants 
with half-word instructions as desired. By the Assembler's half-word 
pairing convention, two sequential half-word instructions occupy the 
upper and lower half of the same generated object word. A single half- 
word instruction occupies the upper half of the generated word and the 
Assembler pads the lower half with zeros. 

The e-operand may be any expression resulting in a 16-bit value. 
NO OPERATION (FULL WORD) 



3l|50|2*|2«|27|2C 


23|2«|23 


22|2l|20 


••M ,T 




I3|l4|l3|l2 


• 1 • 1 M • 9 I 4 IMM'I° 


20 





















NOOP 



.- B 



o 



a - spec i f ies B 
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NO OPERATION (HALF-WORU) 



9| *j.3|2|.|.0 


.|.|T 









20 





3 









iino 



(B ) B 

o o 



STORE ZEROS 



5.|30| 2 .|»|27|" 




»| 2 .|20 


.»|.a|.7 


it 


lS|l4(lS 


• 2|l>|.0l • I • i 7 


t|»|4|s|2|ll0 


23 





k 


b 


i 


s 


y 



SZ y.k.b.s 



- Y 



This is equivalent to the STORE B instruction where B is B . 

a o 



INDIRECT WORD 





50 


2 t| 2 .| 2 7| 2 .| 29 | 2 4| 2 3| 22 | 2 .| 2 


It|l*|l7 




lS|l4|l3 




1 





not used 


b 


i 


s 


y 



IW y.b.s 



This format is for indirect word addressing only. Cascading continues 
until the i-field is equal to zero. Indexing is available at each 
cascade level. 

INDIRECT WORD, CHARACTER 



Si 


90 


2 t| 2 t|27| 2 t|2S 


2 4|»| 22 |2l| 2 


I«|l«|l7 




.»|.4|,S 


-»l"|.0|.li|7|.|s|4|»| 2 |.|0 


[) 


1 


v: 


P 


b 





s 


y 



IWC y,w,p,b,s 



w = number of bits in the character 

p = least significant bit position of the character 

b normal 

i - zero 

s = normal 

This format is for single character addressing only. The character de- 
fined by p and w is stored in the arithmetic register (specified by the 
parent instruction) right-justified and zero-filled on the left. The 
range of p is ()£p*31. The range of w is Uw s 31 only if p is ^ 
32 . 
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INDIRECT WORD, CHARACTER, INCREMENT 



SI 


90 


2«]lt|<T|i«|29 


Z4]29|22|2l|20 


it|n|ir 


it 


I9|l«|l9 


l2|n|lO|*|t|7|«|S|4|9|2|l|0 


1 


1 


W 


P 


b 





S 


y 



w = number of bits in the character 

p = least significant bit position of the character 

b - normal 

i = zero 

s - normal 

This formal is for successive character addressing. The character defined 
by p and w is stored in the arithmetic register (specified by the parent 
instruction) right -j ust if ied and zero-filled on the left. The range of p 
is 0*p ^31. The range of w is l^w^31 only if p + w iss32. 

After the character has been obtained, the indirect control word is 
modified for subsequent addressing of the next character. This sequential 
character addressing assumes the next character contiguous, of the 
same size, and lower in bit position than the present character. If the 
next character would lie outside the current 32 -bit word, the character 
is assumed to lie in the next sequential memory word with its most 
significant bit in bit 31 of that word. Modification of the indirect 
control word occurs accordingly. 



INDIRECT WORD, SPECIAL BASE 



91 


90 


2* 


2t|27|2«|29|*«|29|"|2.|20 


It|lt|l7 


it 


.S|.«|.9|.2|H|.0|tMr[«|»|4|9|2|.|0 











not used 


b 


i 


sy 



IWS sy,b 



The contents of the b -field is a base register designator. The next 
address is the sum of the contents of the indicated base register plus 
the 16-bit D-field. 
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INUIHKCT WORD , SPECIAL INDEX 



3i 


90 


29 


»1*'I"I»M»I»M"> 


'•hi" 




I3|l4|„|,2| 






• 








1 


not used 


b 


i 


sy 



IWB sy t b 



The contents of the b-field is an index register designator, where t he- 
contents of the index register is in the format of the P-register. The 
next address is the sum of three quantities: 

1. The contents of the base register designated by (B^)^ ^ 

( Vl5-0 

The 16-bit I) -field. 
MEMORY PROTECTION 



ail»0|29|2>|27|26|»l24|»|«Ti7 



"iiii 17 " ^l'«l'»l'2|"l'<>l»|«H«H«l»H 1 | 



is 



ia 



ow 



or 



Not used 



MP r,i,or,ow,ia,is 



This mnemonic is used to specify the memory protection register word. 
The special fields are as follows: 

r - bit 0-15 = maximum allowed displacement 
i - bit 20 =1 when instructions may be executed 
or - bit 19 =1 when operands may be read 
ow - bit 18 = 1 when operands may be written 
ia - bit 17 = 1 when indirect references are allowed 
is - bit 16 =-1 when computer will use B and S-registers in indirect 
addressing 
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BUFFER CONTROL WORD 



SI |S0|29]26]27|26|25|24|23|22]2I |20| l»| II 


l7|.«|.S|.4|.3|.2|..|.0|9|t|7|.|»|4|3|2|.|0 


Final Address 
Compare Bi ts 


y 



Description: 

1 - length of buffer in whole words where <1 £ 16384 

This instruction permits the programmer to code buffer control words 
symbolically and at the same time inform the assembler of the special 
addressing characteristics required of buffer control words. 

The final address compare bits in bits 31 through 18 of the generated 
object word are computed by the Assembler or Loader. 



BUFFER CONTROL WORD ESI 





2$|27|2«|23|24|23|22|2I |20| l»| It 




k 


Final Address 
Compare Bits 


y 



BCWE y.l.k 



Description: 

1 - length of buffer in whole words where < 1 £ 2048 

This instruction permits the programmer to code ESI buffer control words 
symbolically and at the same time to inform the assembler of the special 
addressing characteristics of buffer control words. The final address 
compare bits in bits 28 through 18 of the generated object word are com- 
puted by the assembler or loader. 
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12.4.11 Input /Output Instructions 

ACTIVATE EXTERNAL FUNCTION CHAIN ON C. 

J 



3.|3o|2»|2t|27|2< 


2S|2« 


23|22|2l|20 


19 


it 


Ir|l*jl9|l4|lj|l2|ll|l0f»|i|7 [«h|«|3|2|l|0 


16 


k 


J 


m 


c 


y 



AFC j.y.e 



k - 2 

j - normal 
m - not used 
c - normal 

Transfer Y to bits 55 through 38 of the appropriate chain pointer in IOC 
control memory and set the external function chain for channel j active. 



ACTIVATE INPUT CHAIN ON C, 

J 



3l{30|Z9[2t|27|26 



16 



29 24 



23 



EM 



20 



.T|.i|,3|,4|,3|.2|nl l Ol»l«j7|«|>|4l 3l2|.|0 



AIC j t y t c 



k - 

j - normal 
m - not used 
c - normal 

Transfer Y to bits 55 through 38 of the appropriate chain pointer in IOC 

control memory and set the input chain for channel j active. 
ACTIVATE OUTPUT CHAIN ON C. 



3l|30|29|2l|27]26 


23|24 


23j22|2lj20 


it 


it 


.7|.«|.5|.4|.3|.2l..|.0|t|t|7|t|»|4|3|2ll|0 


16 


k 


j 


m 


c 


y 



AOC j.y.c 



k - 1 

j - normal 
m - no I used 
c. - normal 

Transfer Y to bits 55 through 38 of the appropriate chain pointer in IOC 
cont rol memory ad set the output chain for channel j active. 
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ACTIVATE EXTERNAL INTERRUPT CHAIN ON C. 

J 



Si|so|j»|m|it|m 


2t|24 


IS|»|2l|tO 


It 


it 


.T|.t|.t|u|. S |. 2 |..|.0|t|t|7|t|5|4| 9 |l|.|0 


16 


k 


j 


m 


c 


y 



k - 3 

j - normal 
m - not used 
c - normal 



Transfer Y to bits 55 through 38 of the appropriate chain pointer in IOC 
control memory and set the external interrupt chain for channel j active. 

CLEAR BIT 



9l(SO|2t|Xt|27|tt 


2S|2«|23|l2|2l[20 


it 


it 




26 


kj 


m 


c 


y 



IBZ kj,y,c 



- Y. . (0 £ kj * 31) 



k - special 
j - special 
m - not used 
c - normal 

The k- and j -fields are used in combination to designate a bit position 
where £ kj £ 31 . 

Clear bit kj of (Y) to zero. 
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INITIATE EXTERNAL FUNCTION BUFFER ON C. 



3.| 9 o|z»|z»|>r| 2 « 


"I* 4 


23]22|2I (20 


19 


it 


,r| t .|, S |,«| lS |,2|n|,o|.|.|7|«h|4| ,121, |o 


12 


k 


J 


m 


c 


y 



k - special 
j - normal 

m - m = 1 - with monitor; m = - without monitor 
c - c = 1 ' - activate chain on buffer termination; 

c = - do not activate chain on buffer termination 

Initiate an external function buffer on channel j as defined by k. 

k = - one-word buffer with force; Y is the buffer control word 
k = 1 - one-word buffer without force; Y is the buffer control word 
k = 2 - n-word buffer; (Y) is the buffer control word 
k = 3 - unused 
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INITIATK KXTKRNAL INTKKRUPT BUFFKR 



si|so|2t|>t]2r{t« 


29|2« 


2l]Z2|2l|20 


It 


it 


ir|l«|.»Il4|.S|l2|ll|.0|t|t|7|«h|4|3|2|>|0 


13 


k 


j 


m 


c 


y 



k - special 
j - normal 

m - m = 1 - with monitor; m = - without monitor 
c - c = 1 - activate chain on buffer termination; 

c = - do not activate chain on buffer termination 

Initiate an external interrupt buffer on channel j as defined by the 
k-designator. (Y) is the buffer control word. 

k = - No transfer. The buffer current address is incremented by 1 
after each request. 

k = 1 - For each request, transfer external interrupt code word bits 
7 through to bits 31 through 24, 23 through 16, 15 through 
8, and 7 through of memory, in that order. The current buffer 
address in incremented by 1 after each 4 transfers. 

k = 2 - For each request, transfer external interrupt code word bits 
15 through to bits 31 through 16 and 15 through of memory, 
in that order. The current buffer address is incremented by 1 
after each 2 transfers. 

k = 3 - For each request, transfer all 32 bits of the external interrupt 
code word to memory. The current buffer address is incremented 
by 1 after each transfer. 

The monitor interrupt flag controls when an external interrupt request 
is sent to the processor (s) at buffer termination. 
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INITIATE INPUT BUFFER ON C. 

J 



9l|SO|tt|»|27|X« 


29|24 


»|22|2l|SO 


It 


it 




10 


k 


j 


m 


c 


y 



k - special 
j - normal 

m ■■„ m = i _ with monitor; m = - without monitor 
c - c =■ 1 - activate chain on buffer termination; 

c ■= - do not activate chain on buffer termination 

Initiate an input buffer on channel j as defined by the k -field (Y) is 
the buffer control word. 

k - o - No data transfer. The current buffer address is incremented 
by one after each request. 

k = 1 - For each request, transfer input bits 7 through to bits 31 

through 24, 23 through 16, 15 through 8, and 7 through of memory, 
in that order. The current buffer address is incremented by one 
after each four transfers. 

k = 2 - For each request, transfer input bits 15 through to bits 31 

through 16 and 15 through of memory in that order. The current 
buffer address is incremented by one after each two transfers. 

k ■ = 3 - For each request, transfer input bits 31 through to bits 31 

through of memory. The current buffer address is incremented 
by one after each request. 
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INITIATE OUTPUT BUFFER 



»i|so|i*|ii]tr|i« 


"I 14 


Zl|t2|ll|lO 


It 


it 


I7|l«|ll|l4|l9|l||ll|l0|«|l|7 |«|»|«(»(2llj0 


11 


k 


J 


m 


c 


y 



k - special 
j - normal 

m - m = 1 - with monitor; m = - without monitor; 
c - c = 1 - activate chain on buffer termination; 

c = - do not activate chain on buffer termination 

Initiate an output buffer on channel j as defined by the k-designator . 
(Y) is the buffer control word. 

k = - Transfer 32 bits of zeros for each request. The current buffer 
address is incremented by one after each transfer. 

k = 1 For each request, transfer to output bits 7 through from 

memory bits 31 through 24, 23 through 16, 15 through 8, and 7 
tlirough 0, in that order. The current buffer address is in- 
cremented by one after each four transfers. 

k . = 2 - For each request, transfer to output bits 15 through from 

memory bits 31 through 16 and 15 through 0, in that order. The 
current buffer address is incremented by one after each two 
transfers. 

k - 3 - For each request, transfer to output bits 31 through from 
memory bits 31 through 0. The current buffer address is in- 
cremented by one after each transfer. 
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JUMP ( INPUT /OUTPUT) 



3l|90|t»|2t|27|2C 


"I 1 * 


>3|22|2lf20 


l» 


IS 




20 







■ 





c 






JIO y,c 



Y -* chain pointer 

k - not used 
j - not used 
m - not used 
c - normal 



Load the chain pointer with Y. 
LOAD IOC CONTROL MEMORY 



5)|30|2*|2t|27|2« 

22 


29j24|23|22|2i|zo 

kj 


19 

m 


it 

c 


y 



(Y) -» IOC control memory address kj 



k - special 
j - special 
m - not used 
c - normal 

The k- and j-fields are used in combination to specify an IOC control 
memory address where £ kj £63. 

Load the lower 32 bits of the IOC control memory address specified by 
kj with (Y) . 
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LOAD KKAI. TIMi; CLOCK 



3 .|so|>«|t«|ir|2. 




IS|22|Zl|lO 


tt 




l7l.«|,»|,4|.»|.2|..|.0|t(«|T|«|»|4h|2|.|0 


23 











c 


y 



(Y) - RTC 

k - not used 
m - not used 
c - normal 

Load the real-time clock with (Y) . 



SET BIT 



3l[90|2*|t«|27|2« 


2s|2«l2J|22j2l|20 


it 


it 






25 


kj 


m 


c 


y 


1 - 


Y. . (0 
kj 




kj £ 31) 





k - special 
j - special 
m - not used 
c - normal 



The k- and j-fields are used in combination to designate a bit position 
where £ kj £ 31. 

This instruction sets bit kj of (Y) to one. 



SET EXTERNAL FUNCTION MONITOR INTERRUPT REQUEST ON Cj 



3l|30|2t|2»|27|2« 


"I* 4 


2»|22| £ .|20 


19 


it 


I7|l«|l9|l4|l9|l2|ll|l0|»|t|r|«|5|4|s|2| 


|o 




15 


2 


J 


m 


c 


not used 


FMIR j t c 



n - not used 
c - normal 

Set the external function monitor interrupt request on channel j. 
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SET EXTERNAL INTERRUPT MONITOR INTERRUPT REQUEST ON Cj 



3i|30|2»|n|27|2» 


23|24 


23|22|2l|20 


It 


it 


I7|l«|is|l4|is|l2|ll|l0 


•M'M»M»I»I 




15 


> 
J 


j 


m 


c 


not 


used 





XMIR j t c 



3 

normal 
not used 
normal 



Set the external interrupt monitor interrupt request on channel j 
SET INPUT MONITOR INTERRUPT REQUEST ON Cj 



3i]SO|2*|2t|27]2« 


29|2« 


23|22|2.|20 


It 


it 


.7|.«|. 9 |.4|.3|.2|..|.0|t|t|7|«|s|4|3|2|l|0 


15 





j 


m 


c 


not used 





normal 
not used 
normal 



Set the input monitor interrupt request on C j . 
SET OUTPUT MONITOR INTERRUPT REQUEST 



3l|30|29|2t|27]2C 


23|24 


23|22|2l|20 


It 


it 


I7|.t|.»|.4|.3|l2|..|.0|t|t|7|t|t|4|3|2|.|0 


15 


1 


j 


m 


c 


not used 



1 

normal 
not used 
normal 



IMIR j,c 



OMIR j,c 



Set the output monitor interrupt request on Cj 
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STORE IOC CONTROL MEMORY 





24 




m 


c 


y 



(IOC control memory), . -» Y 



k - special 
j - special 
m - not used 
c - normal 

The k- and j-fields are used in combination to designate an IOC control 
memory address where £ kj £ 63. 

Store the lower 32 bits of the content of the IOC control memory address 
specified by kj at address Y. 



TERMINATE EXTERNAL FUNCTION BUFFER ON Cj 



SI |90|Z»|tt|27|2« 


29|24 


M|22|*.|*0 


It 


ii 


.T|..|,»|,4|.»|.2|I.|.0|»|S|7|«|»|4| 3 | 2 |.|0 


14 


2 


j 


m 


c 


not used 



k - 2 

j - normal 

m - m = 1 - do not clear buffer monitor interrupt 

m '= - clear buffer monitor interrupt 
c - normal 
y - not used 

Terminate the external function buffer on channel j. 
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TERMINATE EXTERNAL INTERRUPT BUFFER ON Cj 



3.|so|at|2*|ar|*. 


»h 4 


t9|aa|2i(ao 


19 


IS 


Ir|l«|l9|l4|t»|l2|ll|l0|» 


|.|t|.|.|.|.|.|'.|. 


14 


3 


j 


m 


c 


not 


used 



k - 

j - 
m - 



3 

normal 

m = 1 - do not clear buffer monitor interrupt 
m = - clear buffer monitor interrupt 
normal 
not used 



Terminate the external interrupt buffer on channel j 
TERMINATE INPUT BUFFER ON Cj 



Sl|SO|29|2»|27|2« 


2S|24 


29|22|2l|20 


19 


19 




14 


3 


j 


m 


c 


not used 



TIB j,c f m 



k - 

j - 
m - 

c - 

y - 





normal 

m =■ 1 - do not clear buffer monitor interrupt 
m = ■-. clear buffer monitor interrupt 
normal 
not used 



Terminate the input buffer on channel j. 
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TERMINATE OUTPUT BUFFER ON Cj 



)i]S0|2t|2«|2r|2« 


2S[24 


23|z2(zi|tO 


It 


it 


.7|l«|.S].4(.H.2|M|.0|»|t|7|«| 9 |4|S|2|.|0 


14 


1 


j 


m 


c 


not used 



TOB j,c f m 



- 1 



j - normal 

m - m = 1 - do not clear buffer monitor interrupt 

m = - clear buffer monitor interrupt 
c - normal 
y - not used 

Terminate the output buffer on channel j. 
TEST AND SET FLAG 



Sl|90|29|26|27|2« 


23|24 


2S|22|2l|20 


19 


19 


I7|.«|. 9 |.4|. 9 |.2|..|.0|9|9|7|9|»|4| 9 |2|.|0 


25 


k 


j 


m 


C 


y 



ITSF y t c 



1 -•Ygji if was originally cleared, skip; else NI . 

k - not used 
j - not used 
m - not used 
c - normal 

Set flag bit 31 of (Y) to one. If the flag bit was originally cleared, 
the chain pointer is indexed by 2. If the flag bit was originally set' 
to one, the chain pointer is indexed by one. 
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TEST BIT CLEARED 





29]24j23(tt|2l|iO 


it 


is 


.r|i«|. 9 |.4|. 9 |. 2 |..|.o|t|f|r|«[ 9 |4| S |2| 


• 


17 


kj 


m 


c 


y 



TBZ kj,y 



If (Y) = 0, skip; else NI (0 £ kj <; 31) 



m - 

c - not used 



Test the bit of (Y) specified by the combined kj -field for zero. If 
(Y) k j is equal to zero, the chain pointer is. indexed by 2; otherwise, the 
chain pointer is indexed by 1 resulting in execution of NI. The valid 
range is skj <. 31 . 



TEST BIT SET 



Si[)0|2»|2S|zr|2« 


29|24|23|22|2l|ZO 


it 


it 


I7|.t|. 9 |.4|. 3 |.2l..|.0|t|t|7|t|>|4|>|2|.|0 


17 


kj 


m 


c 


y 



TBS kj f y 



If (Y) k f 0, skip; else NI (0 £ kj * 31) 



m - 1 

c - not used 

Test the bit of (Y) specified by the combined kj-field for one. If (Y)^ 
is equal to one, the chain pointer is indexed by 2; otherwise, the chain 
pointer is indexed by 1 resulting in execution of NI. The valid range 
is 0* kj s. 31. 
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Change 2 



APPENDIX A 



CHARACTER CODES 



ASCII 
Character 


ASCII 
Code 


XS-3 

Equivalent -1004M 
or (1004 REX) 


Standard 
Card Punch 


line feed 


012 


00 


0-5-9 


v^oj- j. i o y t i v u i ii 


015 


00 


12-5-8-9 


Snarp 


040 


00 


bl ank 


J 


041 


43 


12-7-8 


ft 


042 


40 (56) 


7-8 




043 


35 (37) 


3-8 




044 


4? 


X 1 «J kJ 


7° 


04^ 




0-4-fl 

\J M vJ 


F 


04 A 


20 (63) 


12 


f 


047 


40 C56) 




( 


050 


55 (61) 


12-5-8 


) 


051 


77 (75) 


11-5-8 


* 


052 


41 


11-4-8 


+ 


05T 


63 (20) 


12-6-8 


I 


054 


62 


0-3-8 


— 


055 


02 


11 




056 


22 


12-3-8 


/ 


057 


64 


0-1 





060 


03 





1 


061 


04 


1 


2 


062 


05 


2 


O 


0A1 


06 


o 


A 
H 


0A4 


07 
\j i 


4 




UO«J 


1 

J. \J 




o 


oaa 
uoo 


1 1 
1 1 


D 


7 


067 


12 


7 


8 


070 


13 


8 


9 


071 


14 


9 




072 


21 


2-8 


i 


073 


16 


11-6-8 


< 


074 


36 


12-4-8 




075 


37 (35) 


6-8 


> 


076 


76 


0-6-8 


? 


077 


23 


0-7-8 


@ 


100 


56 (40) 


4-8 
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ASCII 


ASCII 


XS-3 


Standard 


Character 


Code 


Equivalent 


Card Punch 


A 


101 


21 


12-1 


ti 
u 


102 


or 


12-2 


r 

\j 


KM 


CO 


TOO 

12-3 


I) 


10-1 


27 


12-4 


\i 


ion 


30 


12-5 


F 
r 


Jl/O 


^ 1 
1 


19 A 


VJ 




O w 


1 c- 1 


H 








I 


111 


34 


12-9 


J 


112 


44 


11-1 


K 


i i r i 

J lo 


45 


11-9 
11c. 


r 


1 1 1 


4A 


1 1 _T 

1 X O 


M 


11.) 




11-4 


N 


1 ] 6 


50 


11-5 





117 


51'. 


11-6 


P 
i 




59 


11-7 


o 
V 


1 1 

I c. 1 


Jo 


lift 
1 1 -0 


D 
ft 






1 1 Q 

1 1 - V 


s 


123 


65 


0-2 


T 


124 


66 


0-3 


11 
u 


1 ^r> 


A7 


n 4 


V 
V 


1 9 A 


70 


0-5 


n 


l 97 


7 1 


0-6 


X 


130 


72 


0-7 


Y 


131 


73 


0-8 


Z 


132 


74 


0-9 


c 


133 


17 


12-2-8 


/ 


134 


15 


0-2-8 


1 


135 


01 


11-2-8 


♦ 


136 


00 


11-7-8 




137 


00 


0-5-8 
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SPECIAL CHARACTER CODES FOR THE OPTIONS DECLARATION 

Standard Card 



029 


026 


U (ULTRA) 


Punch 


046 


053 


053 


12 


042 


042 


047 


7-8 


075 


075 


076 


6-8 


047 


047 


072 


5-8 


0100 


047 


047 


4-8 


043 


075 


075 


3-8 


072 


072 


053 


2-8 


077 


077 


051 


0-7-8 


076 


076 


0134 


0-6-8 


0137 


0137 


050 


0-5-8 


045 


050 


050 


0-4-8 


054 


054 


054 


0-3-8 


0134 


0134 


012 


0-2-8 


0136 


0136 


015 


11-7-8 


073 


073 


073 


11-6-8 


051 


051 


0135 


11-5-8 


052 


052 


052 


11-4-8 


044 


044 


044 


11-3-8 


0135 


0135 


042 


11-2-8 


041 


041 


075 


12-7-8 


053 


053 


074 


12-6-8 


050 


050 


0133 


12-5-8 


074 


051 


051 


12-4-8 


056 


056 


056 


12-3-8 


0133 


0133 


0100 


12-2-8 
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APPENDIX B 



SUMMARY OK SYSTEM STATEMENTS 



LI NOTATION OF STATEMENTS AND OPERATIONS 

Wherever a statement or operation is discussed in this appendix, a uniform 
system of notation is used to define the structure. This notation is not a 
part of CMS-2, but is a standardized notation that may be used to describe the 
syntax (construction) of any programming language. It provides a brief but 
precise means of explaining the general patterns that the language permits. 
It does not describe the meaning of the statements or operations; it merely 
describes structure; that is, it indicates the order in which the operands 
must appear, the punctuation required, and the options allowed. 

The following rules explain this standard notation: 

1. A word written in lowercase letters represents the type of entry to 
be made by the programmer. This word may be hyphenated. 



2. 



name denotes an entry of a name. 

data -unit-name denotes an entry of a data unit name. 

A word written in uppercase letters or special characters denotes an 
actual occurrence of that word or character in the language. 

name DISPLAY data -unit-name $ This example denotes the entry 



of a name followed by the entry 
of the reserved word DISPLAY 
followed by an entry of a data 
unit name. 



3. 




statement. 



4. 



Square brackets [ ] are used to denote options. When one unit is 
enclosed in brackets, the unit may or may not appear. When more than 
one unit is enclosed in brackets, any one of the alternative units may 
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5. 



or may not be chosen to appear. In either case, it is possible that 
no unit may appear. It is generally not possible that more than one 
unit will appear. 

This example indicates that a name may 
appear in the statement format. How- 
ever, this unit is not required, 
denotes that the type of entry indi- 
te • may appear one or more times 
in succession, where each entry is delimited by the word preceding • . 
This does not imply that all entries should be identical. It does 
imply, however, that all entries should be the same type of entry 
indicated by the word preceding the three dots. 



[name] 



The use of • • • • 

cated by the word preceding 



data uni t name 



This example indicates that one or more 
data unit names may occur in succes- 
sion as entriest separated by commas. 
Thus, the following would be a legal 
entry: ALPHA, BETA, GAMMA 



B.2 MONITOR STATEMENTS 

$SEO, ddd [non-numeric-nonspace-non-$ character] [$ [comments]] 



$.TOB [~, [user identification], [project identification], [time limit in decimal], 



[page limit in decimal], 



C 
S 

TS 



, [26] J [$ [communis]] 
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$K()I [$ I common is]] 



$ENDJOB [$ [comments]] 



$CMS-2 [$ [comments]] 



$ASM [, U] [$ [comments]] 



$UTILITY [$ [comments]] 



$LIBEXEC [$ [comments]] 



$L0AD [ f 



TRACE 

PTRACE 

SNAP 

RANGE 

DISPLAY 



• • • 



J [$ [comments]] 



*ARFr r • r° Ctal nUmber 1 [$ [comments]] 

$AREG L » • [decimal number DJ J 

$BREG [ , . r° Ctal " UmbG 5 n l • • •] [$ [comments]] 

«- ' [^decimal number DJ «J JJ 

$KEYSET [ , • |^Qppj • t t ] [$ [comments]] 



$CALL t 



address section name 
external definition name 

bound section name 



[+ foetal number Yj 
- \decimal number DJ J 

[ + foetal number Yj 
^decimal numberjj 



[$ [comments]] 
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$TYPE, message 
$HALT, message 
$REMARK, message 



address section name 
[external definition name 

$TRA, } 'f f ortal ni ,mh er ll ~ } 1$ [comments]] 

bound section name 



}|f+ \ foe tal number \ \ 
\-J \decimal number Dj J 

foetal number \ 
^decimal number/ 



$DUMP f 



I 

H 


D 

C 

IC 

OC 

HC 

OC 

DC 

CC 



faddress section name \ 
\external definition name J 



bound section name 



[{-}{ 



octal number 
decimal numbe 



r d}_ 



foetal number \ 
\decimal number Dj 



[$ [comments] 
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$SNAP, 



{address section name \ I / + \ 
externa] definition namej Ll~J 



bound section name 



I 

H 

Q 
D 

C 

IC 
OC 
HC 
OC 
DC 
CC 



[decimal dumps count] 



{octal number \ | 

de c i ma 1 numbo r I )J J 

foetal number \ | 

^decimal number Dj J 



[decimal dump frequency ] f [ decimal start dump count ] 



faddress section name 1 [~/ + \ / 
^external definition namej |\-J \ 



octal number 
decimal number 



bound section name 



[ + foetal n 
^decimal 



number 
numbe 



r d} 



foetal n 
^decimal 



number of words 
number D of words 



} 



t • • 



[$ [comments J j 



$PATCH [$ [comments]} 
Patch Statement: 



faddress section name 



, \ f/ + \ foetal number 1 "I 

\external definition namej |_\ -J \decimal number DJ J 



bound section name 



[ 



+ 



(octal number 
decimal number 



I, • up to twelve octal digits • • • 
0, • up to eleven octal digits • • • 
K t • up to thirteen octal digits • • • 

C, (character string) 



[$ [comments j J 
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$ASG, 



SIP, 



SOP, 



SHC, 



Tl 
T2 
T3 
T4 
T5 
T6 
T7 
T8 
CR 
CP 
HP 
KB 
PR 
PP 



Tl 
T2 
T3 
T4 
T5 
T6 
T7 
T8 
CR 
KB 
PR 

Tl 

T2 
T3 
T4 
T5 
T6 
T7 
T8 
CP 
PP 

Tl 
T2 
T3 
T4 
T5 
T6 
T7 
T8 
HP 
KB 



Tl 
T2 
T3 
T4 
T5 
T6 
T7 
T8 
CR 
CP 
HP 
KB 
PR 
PP 




[$ [comments 
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$LDUYK-20[$ [comments]] 
$ FORTRAN 1$ [comments] ] 
$SYSMAKER [$ [comments]] 

B.3 LOADER STATEMENTS 

Table Size Declaration: 

TSD, »name = decimal integer ••• [$ [comment]] 
Library Selection: 

LIBS, •internal library name [ (external library name) 
• *• [$ [comment] ] 

Element Selction: r 



SEL-ELEM [element name] [ (key) ] [ 




, ALL 
, ONLY 

, decimal integei 



[$ [comment] ] 



Loader Options Select: 



LOPTIONS • 



FORCE 

NOID 

NOMAP 



• • • 



LOBJECT 
,LODGO 
SAVLODGO 
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Combine Elements Selection: 



[Section name] 



DATAPOOL 

TABLEPOOL 

BASE 



> 



[ ( octal digit) ] 



LOCDDPOOL 



, • element name • • • [( octal integer)] 
[ $ [ comment ] J 

End Card: 

END L$ [comment J j 

B.4 LIBRARIAN STATEMENTS 
/LIST 

/BUILD internal-library-name 

/EDIT old-internal-library-name [ (old-external-library-name) J 



/RELEASE , •internal-tape-name [ (external-tape-name)] • • • 
/HI STENT notes 



[, new-internal-library-name] 



/ENDLIB 



/TAPID 



, • internal-tape-name [ (external-tape-name)] • • • 



/ADD 



name [(key)] 




internal -tape -name [(external -tape -name)] 



SYSIN 



[NOLI ST] 
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/COPY 



name [(key)j 



AU 

S 

L 
C 



(key) 



r s 
o 

L 
IC 



THRU name [(key) J 



S 

L 

CJ J 



S 

L 

L IC 



[internal -tape-name [(external -t ape-name) J J [NOLISTj 



/DEL 



name [(key)] 
(key) 



THRU name [(key)] 



/CHANGE name [(key)] 



[ TO 



name [(key)] 



(key) 







[-1 
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FROM HEADER 

t • name [(key)] • • • 

/BEGINEL 
/ENDEL 
/CORRECT 
/ENUCOR 



/name [(key)] 




/END 

/I [item-number] 

/[) fi tern-number [THRU item-number] 



/NOLI ST 
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HIST 
DIR 



/PRINT , • 



name [(key)] 









H 


B 


► 








BOTH 




ALL 






* ( 


fsl 


L 


> 









(key) 



Qtem-number [THRU i tern-number ]J 



• • • 



ALL 











/PUNCH , • 


name [(key)] 


*■ < 


in 











£i tern-number [THRU item-number £j 



(key) 









»] 
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B.5 PERIPHERAL UTILITIES STATEMENTS 

TYPE [([message to operator])] [•[comments]] 

HALT [([message to operator])] [•[comments]] 

[• [comments]] 

DISMOUNT [tape name] [• [comments]] 
FILSKP [tape name] [ t [no. of files]] [• [comments]] 

RECSKP [tape name] [ f [no. of records]] [• [comments]] 
BKFILSKP [tape name] [, [no. of files]] [ • [comments]] 
BK RECSKP [tape name] [ f [no. of records]] [ • [comments]] 
REWIND [tape name] [• [comments]] 

WRITE [tape name], location name [ f [no. of words] [.[format]]] 
[ • [comments]] 
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WRTFILMK [tape name] [• [comments]] 

DUPLICAT [tape name] , [format] , [tape name] , [format] , 
no. of files [ , [no. of records]] 

[• [comments]] 

no. of files] , no. of records 

REFORMAT [tape name] , [format] , [tape name] , [format] , item size , 
no. of items [ , [no. of files] [ , [skip words]]] [• [comment]] 

CARD TAPE [tape name] [• [comments]] 

BOOTWRT [tape name] , location name [ , [no. of words] [ , 
[load base] [ , [M]]]] [• [comments]] 

CONVERT [tape name] [ , [tape name] [ , [data type] [ , [CONTINUE]]]] 
[• [comments]] 

READ [tape name] , location name [ , [no. of words] [ , [format]]] 



[• [comments]] 

LIST tape name [ , [tape format] [ , 
]]]] [• [comments]] 



"i" 


H 

Q 
D 

LC. 



[ , [no. of files] [ , no, of records] 



TAPEOUT [tape name] [ , [no. of files]] [• [comments]] 



COMPARE [tape name] , [format] , [tape name] , [format] , 
no. of files [ , [no. of records]] 
[no. of files] , no. of records 



[• [comments]] 
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B. 6 COMPILER STATEMENTS 

[name] BASE [([T] [, integer-value])] [integer -value] $ 
CMODE $ 
CMS-2 $ 
CORRECT $ 

CSWITCH -ON, • nam e • • • $ 
CSWITCH -OFF,, name. ••$ 
CSWITCH, • name ••• $ 
CSWITCH -DEL $ 

[data-unit] DATA constant [constant] $ 

[name] DATAPOOL [([T] [, integer-value])] [ integer-value] $ 



DEP, • element-name [ (key) ] • • • $ 
DIRECT $ 

END -HEAD [name] $ 
END -SYSTEM [name] $ 
identifier EQUALS value $ 



DEBUG ,• 



f 



'RANGE 
| TRACE 
'PTRACE 
DELETE 



DISPLAY 
iSNAP 



• •• $ 
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identifier EXCHANGE character-string $ 
EXECUTIVE $ 

[name] HEAD [comment] $ 

[name] LOCDDPOOL [([T] L. integer-value])] [integer-value] $ 

identifier MEANS character-string $ 
NITEMS (name) EQUALS integer value $ 



OPTIONS 



SOURCE [( 



LIST ' 
CCOMN > 
CSRCE 
CARDS- 



)] 



• • • $ 




\OPT 
CNV ' 



OBJECT [(< 



CCOMN 
CARDS 
COBJT 
SA 



CR 



I PRINT 
CCOMN > 




)] 



MONITOR 
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SEL-ELEM name [(key) J [ , ONLY] $ 

S EL -HEAD name [(key)] [ , ONLY] $ 

SEL-POOL name [(key)] $ ^ 

SEL-SYS [(key) ] [ ,()NLY] $ 

SPILL $ 

SYS-INUEX, • b-reyister index-name ••• $ 
[name] SYSTEM [comment] $ 

[name] TABLEPOOL '[([T] [, integer-value])] [integer-value] $ 
TERMINATE $ 

name AUTO-DD [comment] $ 

[label] CHECKIU file-name ■ |(Iharacter-string)} ' [ THKN statement] $ 
[label] CLOSE file-name [THEN statement] $ 
COMMENT comment $ 
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CSWITCH name $ 



[label] DEFID file-name { ( ™ A ^ r . string) } [THEN statement] 

[label] DECODE data -element / ima 9 e \ 

l< , • image • • •) J 

format-name [THEN statement] $ 



[name] DISPLAY {*T data _ e iement • • •} [THEN statement] $ 

[label] ENCODE data-element I * ma 9 e Y 

{, • image • • • JJ 

format-name [THEN statement] $ 

END -AUTO -DD name $ 

END vary -block -name $ 

END -CSWITCH name $ 

END-CSWITCHS $ 

END -FUNCTION function-name $ 

END-LOC-DD jnamej $ 

j^labelj END FILE file -name |THEN statement J $ 
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EXTREF 
EXTDEF 
TRANSREF 



FORMAT name f • [n][(] 



Ew.d 

Iw.d 

Fw.d 

Ow.d 

Iw 

Aw 

wX 

Tw 

Hollerith-constant 



»[)]••• 



EXTREF I 
EXTDEF ! 
| TRANSREF ( } 
LOCREF 



FUNCTION name (formal-input-parameters) [type] $ 



[label] GOTO 



f statement-name [special-condition] V 
\switch-name [index] [INVALID statement-name] [special-condition] } $ 



[label] IF 



. . i i + f VALID \ ' 
table-element ^INVALID J 

relational -expression 
Boolean-data-element 
Boolean-expression 

DATA / P" ™ \ 
A A \N0TF0UND/ 

data-unit J* EVENPl 
( ODDP J 



THEN statement $ 



END-PROC procedure-name $ 



END-SWITCH fswitch-name-a [ , switch -name -b] 

^procedure-swi tch-name-a [ , procedure-switch-name 



END-SYS-DD name $ 
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END-SYS-PROC name $ 
END -SYSTEM name $ 
END-TABLE table-name $ 
END -TRACE $ 



FIELD name 



F [(R)J 
B 

H number-of-characters 
S li st-of-status-con§tants 

f S 

A number-of-bits \, 



number-of-f ractional-bit s 

1UJ 

I number-of-bits 
[word-location starting-bit-position] [P constants] [V(x,y)J $ 





EXTREF 




( < 


EXTDEF 


> ) 




TRANSREF 





H 



* maximum-number-of -records f^j 
maximum-record-size hardware-name [states] [WITHLBL] $ 



FILE name <B 



[label] FIND expression [VARYING loop-index] 

[FROM initial-value] " ^a« 1 " Val - Ue } [BY. [*3 increment]] $ 



NOTE 

FROM, THRU, WITHIN, and BY may 
appear in any order. 
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L label] INPUT .< 



filename 

OCM 

READ 

PRINT 

PUNCH 



f receptacle 1 
\{ , • receptacle • • • )J 



[format name] [THEN statement] $ 



EXTREF ] 
( { EXTDEF > ) 
TRANSREFJ 



ITEM-AREA t • name • • • $ 



EXTREF | 
EXTDEF > ) 
TRANSREF J 

[major-index-name] $ 



LIKE-TABLE name [number-of-i terns] 



[name] LOC-DD [comments] $ 



LOC -INDEX , • name • • • $ 



MODE /variable declaration! 
\field declaration j 



INPUT 

[label] OPEN filename ( OUTPUT 

SCRATCH 



> [THEN statement] $ 



data-unit OVERLAY , • data-unit • « • $ 
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Change 5 



L label] OUTPUT 



filename 

OCM 

PRINT 

PUNCH 

READ 



f data-image ^ 
\( , • data-image • • • )J 



[format name] [THEN statement] $ 



[label] PACK data-unit WITH , • data-unit • • • 
[THEN statement] $ 





EXTREF 




( * 


EXTDEF 


^ ) 




TRANSREF 

, 4 





[INPUT 

P-SWITCH name [(variable)] , name 
f • formal -parameter • • • ] [OUTPUT f • formal -parameter • • • ] 



[label] procedure-switch-name [USING index] 

[INVALID statement -name] [INPUT , • actual-parameter • • • ] 
[OUTPUT , • actual -parameter • • • ] [THEN statement] $ 



EXTREF 
EXTDEF 
I TRANSREF ( 
LOCREF 



PROCEDURE name [INPUT , • formal -parameter • • • ] 



[OUTPUT , • formal -parameter • • • ] 
[EXIT , • abnormal -exit -name • • • ] $ 
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[label] procedure-name [INPUT f • actual -parameter •••■]■. 

[OUTPUT , • actual-parameter • • • ] [EXIT , • statement-name • • • ] 
[THEN statement] $ 



{field-reference} RANGE u PP er - v * lue t. lower-value] $ 



[label] RESUME vary-block-name $ 



[label] RETURN [abnormal exit] [special-condition] $ 



[label] SEARCH f ile-name 1 \ [CONTIN] data-unit NO FIND name 



[THEN statement] $ 



[label] SET , • data-element • • • TO expression [THEN statement] $ 




[label] SHIFT data-unit < 
[THEN statement] $ 



CIRC 

ALG 

LOG 



count [INTO data-unit] 



name SNAP data-element $ 



[label] STOP [THEN statement] $ 
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EXTREF 1 
EXTDEF > ) 
TRANSREFJ 



SUB-TABLE name initial -item-number 



ma 



ximum-number-of-i terns [major-index-name] $ 



[label] SWAP data-element , data-element [THEN statement] $ 



SWITCH 



name 



name-a , 



["(variable-name) 

[_ i * switch-point • • «J 

name-b 



(statement-name [ , statement-name]! ^ 
procedure-name [ t procedure-name] J 



constant t statement-name $ 



constant , procedure-name $ 



name SYS-DD [comment] $ 



name SYS-PROC [comment] $ 



name SYS-PROC-REN [comment] $ 
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( < 



EXTREF 
EXTDEF 
TRANSREF 



> ) 



TABLE name 



(type) 

words-per-item 
H < NONE 
V MEDIUM 

DENSE 

v 

'(type) 

words-per-i tern 
NONE 
MEDIUM 
DENSE 



[INDIRECT] number-of-items [major-index-name] 



[INDIRECT] , • dimension 



label VARY loop-index [FROM initial-value] 

{THRU f inal-value\ rDV r ,i < „»,.„„,„,,* n <t 

llITTI1T ., > [BY [±] increment] $ 

WITHIN name J L L 



NOTE 

FROM, THRU, WITHIN and BY may appear in any 
order. 



EXTREF | 
EXTDEF > 
TRANSREF j 



name 



VRBL 



( , • name • • • ) 



I number-of-bits 

A number-of-bits number-of-f ractional-bits 

S list-of-status-constants 

H number-of -characters 
B 

F [(R)] 



[P constant] [V(x,y) J $ 
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B.7 ASSEMBLER STATEMENTS 
Start Assembly (ULTRA) Card : 



Stop Assembly (OFF) Card: 
*OFF 



Absolute Directive Card: 
ABS label 



Byte Directive Card: 
BYTE el [,e2] 



Character Directive Card : 
CHAR , • jc.e} • • • 

DO Directive Card: 

[label] DO e , [statement] 

END Directive Card: 
END 




D 
P 



PS 
SP 
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Equate Directive Card: 
label EQU e 

EVEN Directive Card: 
EVEN 

ODD Directive Card: 
ODD 

FORM Directive Card: 

label FORM , • ie} • • • 

List Cross Reference Table Directive Card: 
LCR 

Library Select Directive Card: 

LIBS , • {.internal-name} [(external-name)] • • • 

Library Element Directive Card: 

LIB , • [name] [(version)] • • • 

LINK Directive Card: 

LINK , • {name} • • • 

LIST Directive Card: 
LIST 

ELI ST Directive Card: 
ELI ST 
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B.7 ASSEMBLER STATEMENTS 



Start Assembly (ULTRA) Card : 



*ULTRA 



[■ 



D 
P 
E 
S 
PE 
EP 
PS 
SP 



[ , 



H 




S 




HS 





[■ 



ame [ , version] 



1 



Stop Assembly (OFF) Card: 
♦off 



Absolute Directive Card: 
ABS label 



Byte Directive Card: 
BYTE el [,e2j 



Character Directive Card : 
CHAR , • {c,e} • • • 



DO Directive Card: 

[label] DO e , '[statement} 



END Directive Card: 
END 
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Equate. Directive Card: 
label EQU e 

EVEN Directive Card: 
EVEN 

ODD Directive Card: 
ODD 

FORM Directive Card: 

label FORM , • jie] • • • 

List Cross Reference Table Directive Card: 
LCR 

Library Select Directive Card: 

LIBS , • {internal-name) [(external-name)] 

Library Element Directive Card: 

LIB t • [name] [(version)] • • • 

LINK Directive Card: 

LINK , • {name) • • • 

LIST Directive Card: 
LIST 

ELI ST Directive Card: 
ELI ST 
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NOLI ST Directive Card: 
NOLI ST 



Literal Directive Card: 
$ (e) [, labelj 
label 



LIT 



Punch External Labels Directive Card: 
PXL 



Reserve Directive Card: 
[label] RES e 



Relocation Field Directive Card: 
RF$ e , • lh t l,c} • • • 



Segment End Directive Card: 
SEGEND 



Set Address Directive Card: 

SET ADR e , • [a] • • • 



Word Directive Card: 
WRD e 
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MACRO Directive Card: 

label [*] MACRO [e,[,e 2 ]] 

MACRO Name Directive Card: 
label [*] NAME [e] 

GO Directive Card: 
GO label 



B-28 



M-5035 



APPENDIX C 

SUMMARY OF SERVICE ROUTINE CALLING SEQUENCES 
Request Packets Reference Words 



□CEEcaaacDEECDEDCiatDECoaaiEiDiDDDaaDDooioa 



Y portion or pkt. 
address 



B 


■ 




mod. 





mod. 



IW y t b,s 



»i]so|it 


t.|lT|l.|tt|l«|>llll|t.|IO 


• •] l»f IT 


it 


••|i«|i>|itlH|,o[«|t|r |«|t|4|i|i| i [o 







1 s 

mod. 





Y portion of pkt. address 



IWS y t s 



Standard Input Request Packet 



function code 


status 


user code 




data ad'dress (in indirect word format) 


number of characters 





Standard Output Request Packet 



■■■■■■■■■ 


user code 


■■■■ 


data address (in indirect word format) 


number of characters 





Standard Hardcopy Output Request Packet 



data address (in indirect word format) 



number of characters 
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Tape Assignment/Release Packet 



3 .|SO|tfi M |t7| M |tS|24|2}|2t|2l|20|.»|.a|.T|.«|,S|.4|.S|. 2 |.. 

Tape 






Name 


Wit 


Code 


Device No. 



Tape Control Selection Packet 



SI 90 2t 2t 27 2t 25 14 25 22 



Zl|2O|l»|l0jl7|l> 



Tape 
Controls 



I9|l4|n|l2|ll|l0|»{t 




7 • I 5 4 5 1 2 I 



Logical 
Device 



Get Device Name Packet 

SI jSO|2f|2«l27l2<|>S|24l2»j22fell20| I7l 1*1 18 1 14| is l I2l t \ J 10| t ft 




Device Mnemonic 



7|«|5|4|S|2l<|0 



Logical 
Unit 



Y7777777A 



Centralized I/O Request Packet 



operation 



s ta tus 



user 
code 



logical unit 
no. 



data address (same formats 


as in request packet addr.) 


skip count/number of words 


number of words read/ 
deposit user code 


search identifier/deposit data address 
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Scatter /Gather Centralized I/O Request Packet 



Word 
1 

2 

3 
4 

5 
6 
7 
8 
9 
10 
11 
12 
13 
14 



Sl|SO|29|2e|27|2«|29|24 


23|22]Zl|20]l«|lt]l7|l« 


•9 


14 


I5|l2|ll|l0|» | • 


-l.l.l. Mil. I. 


operation 
(015 or 016) 


Status 


R 

C 


c 


user 
code 


logical 
unit no. 


'/////// /////. 


number of areas in this 
gather write/scatter read 




data address of first area (same format as req. pkt. ) 


number of words/ 
characters in this area 




data address of second area (same format as req. pkt. ) 


number of words/chars. 




data address of third area, if one (same format as req. pkt. ) 


number of words/chars. 




data address of fourth area, if one (same format as req. pkt. ) 


number of words/chars. 




data address of fifth area, if one (same format as req. pkt. ) 


number of words /chars. 




data address of sixth area, if one (same format as req. pkt. ) 


number of words/chars. 





Service Request Call 

Centralized I/O Request 
Is 

IW (packet address ) 

Standard Input Request 
XS io 8 

IW (packet address) 



Type of Packet 
Centralized I/O request packet 

Standard input request packet 
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Service Request Call 
Standard Output Request 

xs ii 8 

IW (packet address) 



Standard Hardcopy Request 
XS 12 Q 

o 

IW (packet address) 

Tape Assignment/Release Request 
XS 3 

IW (packet address ) 

Tape Control Selection Request 
XS 2 

IW (packet address) 

Get Device Name Request 
XS 1 

IW (packet address) 

Check Simulated Jump Key 1 Selection Request 
XS 40 o 

o 

return if simulated key 1 is "on" 
return if simulated key 1 is "off" 



Check Simulated Jump Key 2 Selection Request 
XS 41 g 

return if simulated key 2 is "on" 
return if simulated key 2 is "off" 



Type of Packet 



Standard output request packet 



Standard hardcopy request packet 



Tape Assignment/Release packet 



Tape Control Selection packet 



Get Device Name packet 



None 



None 
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Check Simulated .lump Key 3 Selection Request 

xs r> 8 

return if simulated key 3 is "on" 
return if simulated key 3 is "off" 



Check PTRACE Selection Request 
XS .I3 8 

return if not selected 
return if selected 



Check TRACE Selection Request 

xs n 8 

return if not selected 

return if selected 



Check DISPLAY Selection Request 
XS 45 8 

return if not selected 
return if selected 



Check RANGE Selection Request 
XS46 8 

return if not selected 
return if selected 



Check SNAP Selection Request 
XS47 8 

return if not selected 
return if selected 



Check Floating Point Error Request 
XS 50 8 

return if floating point error has occurred 
return if no floating point error has occurred 
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Type of Packet 



None 



None 



None 



None 



None 



None 



None 



Terminate User Program Request 
XS 51. 



8 



None 



or 

XS 52 



8 



M-5035 
Change 3 



Service Request Call 

Current Time Request 
XS 60g 

IW (address where data is wanted) 

Current Data Request 
XS 6l Q 

IW (address where data is wanted) 



Type of Packet 
None 

- data occupies one word 

None 

- data occupies two words 
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APPENDIX D 
CMS-2 COMPILER RESERVED WORD LIST 

The following symbols are compiler reserved words and may not be used as identifiers 
in a CMS-2 program. 



ABS 


DECODE 


J? UNCTION 


OCM 


flT\T T T 

oPILL 


ALG 


DEFID p| 


GOTO 


ODDP 


STOP 


AND 


DENSE 


GT 


ONLY 


SWAP 


BASE 


DEP 


GTEQ 


OPEN 


SWITCH 


BEGIN 


DHIECT 


' H 


OPTIONS 


SYSTEM 


BIT 


DISPLAY 


HEAD 


OR 


TABLE 


BY 


ELSE 


IF 


OUTPUT 


THEN 


CAT 


ENCODE 


INDIRECT 


OVERFLOW 


THRU 


CHAR 


ENDFILE 


INPUT 


OVERLAY 


TO 


CHECKID 


END 


INTO 


PACK 


TRACE 


CIRC 


EQ 


INVALID 


POS 


UNTIL 


CLOSE 


EQUALS 


LENGTH 


PRINT 


USING 


CMODE 


EVENP 


LIBS 


P TRACE 1 


VALID 


CNT 


EXCHANGE 


LOG 


PUNCH 


VARY 


COMMENT 


EXEC 


LT 


RANGE 


VARYING 


COMP 


EXIT 


LTEQ 


READ 


VRBL 


CORAD 


FIELD 


MEANS 


REGS 


WHILE 


CORRECT 


FIL 


MEDIUM 


RESUME 


WITH 


CSWITCH 


FILE 


MODE 


RETURN 


WITHIN 


t D 


FIND 


NITEMS 


SAVING 


XOR 


DATA 


FOR 


NONE 


SET 




DATAPOOL 


FORMAT 


NOT 


SHIFT 




DEBUG 


FROM 


to 


SNAP 





t Not allowed as a tabular identifier or function. 
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NOTE 



Programmers expecting to make use of CMS-2 run-time 
routines (high-level input/output, debug, and math 
routines) should avoid the use of identifiers beginning 
with RT to prevent duplication of identifiers. Any 
duplication of identifiers, globally defined within the 
run-time library, would not be detected until load time. 
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APPENDIX E 
COMPILER ERROR MESSAGES AND LIMITS 

Source Errors and Warning Messages (Warnings Flagged with * ) 

The following error messages appear as a result of errors detected by the source 
syntax analysis phase of a compilation (OPTIONS SOURCE): 

* DEBUG REQUIRES MONITOR 

A DEBUG statement is only processed if the MONITOR OPTION has 
been specified. 

1 IDENTIFIER GT 8 CHARS 

Attempt to define an identifier greater than eight characters long. 

2 LITERAL GT 132 CHARS 

Hollerith or literal constant greater than 132 characters. 

3 RESERVED WORD USED AS ID 

Illegal use of reserved word as an identifier. 

4 CHARACTER NOT RECOGNIZED 
Illegal ASCII input character. 

5 DECIMAL POINT MISPLACED 

Erroneous use of period not in a constant or illegal label definition. 

* 6 COMMENT TERMINATED BY $ 

Double prime comment not completed before end of statement. 

7 INCORRECT OCTAL CONSTANT 

The digits 8 or 9 appear in an octal constant. 

8 MISPLACED SEL-POOL 

Identifier definition appears prior to SEL-POOL statement. 

E-l 
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9 ILLEGAL INTEGER TAG 

Symbol or constant must be an integer. 

10 NO STATEMENT TERMINATOR 
Missing $ statement terminator. 

11 IDENTIFIER MISSING 

Missing name in a data unit declaration. 

12 DUPLICATE IDENTIFIER 

Attempt to define a previously defined identifier. 

13 OUTSIDE TABLE BOUNDS 

Subtable not contained within table; field not contained within item; 
or multi-word field in a horizontal table. 

14 NO DESCRIPTIVE OPERATOR 

Missing descriptive or separator term. 

15 ILLEGAL IN MINOR HEADER 

Statement is not allowed in minor header (must be placed in major header) 

16 TOO MANY DIMENSIONS 

More than seven dimensions in an array declaration. 

* 17 COMMA MISSING 

Comma missing in statement. 

* 18 OVERLAY PARENT MISMATCH 

Data units on right of overlay exceed size of parent data unit. 

19 DUPLICATED OVERLAY 

Data unit appears on right of more than one overlay. 



E-2 



M-5035 
Change 5 



20 OVERLAY SEQUENCE ERROR 

Data unit on right of overlay appeared on left of previous overlay. 

21 UNDEFINED IDENTIFIER 

Referenced data unit has not been previously defined. 

22 SCOPE CONFLICT 

Definition of a global procedure with local parameters. 

23 STATEMENT NOT RECOGNIZED 

Statement placed in the wrong type of element or within the wrong type 
of declarative brackets. 

24 ILLEGAL OPTIONS 

CCOMN has been designated the output unit for both LISTING and OBJECT 
options - options that are produced simultaneously. Only the OBJECT 
option is produced; the LISTING option on CCOMN is ignored. 

*25 PARENTHESIS MISSING 

Parenthesis missing within statement. 

26 SUB/LIKE-TABLE PROHIBIT 

Subtable or like-table declared in an array. 

27 ILLEGAL OVERLAY DATAUNIT 

Illegal data unit appears in overlay. 

28 ILLEGAL OVERLAY PARENT 

Specified data unit may not be used as a overlay parent. 

29 DUPLICATE RANGE 

More than one range statement for the same data unit. 

30 PRESET NOT ALLOWED 

Data unit preset not allowed in AUTO-DD or on an externally 
referenced data unit. 
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31 ILLEGAL HARDWARE NAME 

Illegal hardware device name specified in file declaration. 

32 ILLEGAL FORMAT DESCRIPTOR 

Illegal conversion descriptor specified in format statement. 

33 MORE THAN 1 LEVEL NESTED 

Format descriptors nested (parenthesized) to more than one level. 

34 ILLEGAL IDENT REFERENCE 

Illegal use of identifier in an expression. 

35 ILLEGAL SEZE DESCRIPTOR 

Illegal data unit size attribute (e.g., Hollerith over 132 characters, table defined 
with words per item, too many bits for I- or A-type. ) 

*36 END BRACKET MISPLACED 

Misplaced or missing END- statement. 

*37 STATEMENT REQUIRES MONITOR 

MONITOR OPTION must be declared for processing of this statement. 

*38 CNV REQUIRES NONRT 

Processing of a CNV statement requires the NONRT (or MONITOR) OPTION. 

39 SYSTEM LIMIT nn EXCEEDED 

One of the following compiler limits denoted by nn has been exceeded. The code 
nn has the following values: 

1. Constant conversion limit was exceeded; the value of the constant lies out- 
side the decimal limits (1E57, 1E-38) or the octal limits (1E77, IE -52). 

2. The number of nested subexpressions within the Boolean condition of an IF 
statement may not exceed ten. 

3. The number of libraries requested for retrieval may not exceed ten. 
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4. The number of operands in a DISPLAY statement has exceeded the compiler 
limit. The card column indicator in the error output listing points to the 
operand which first exceeds the limit. This and following operands should be 
written as a separate DISPLAY statement. The limit may be calculated as 
follows: 

a) Allow 3 + n words for each operand, where n is the number of words required 
to contain the operand as a character string; 

b) the sum of the above may not exceed 94. 

5. The maximum number of exit parameters per PROCEDURE declaration is ten. 

6. The number of format descriptors exceeds 94 or the number of operands of 
an input/output list for INPUT, OUTPUT, ENCODE or DECODE statements 
exceeds 94. (For each operand that is a Hollerith constant, also add in the 
number of words required to contain the constant value. ) 

7. A maximum of seven levels of subscripting and function calls per operand is 
allowed. 

8. An item beyond item 255 was specified in a field preset. 

9. The length of a dynamic statement is too long for the compiler to process 
properly. This may be due to the complexity of an expression or an abun- 
dance of embedded notes. 

10. The maximum number of elements declared dependent of another is 58. 

11. A VRBL declaration may define no more than 25 names. 

12. The offset of a sibling overlayed data unit relative to its parent data unit must 
not exceed 65535 words. 

13. More than 250 elements. 

14. Symbol table overflow — number of global and local identifiers. 

15. Field defined or compiler packed beyond word 255. 

16. More than 15 combined nested VARY and BEGIN blocks. 

E-4A/E-4B (Blank) 
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17. More than 10 nested VARYs. 

18. COMENT (or "-type comment) between FIND and IF DATA too long. 

19. COMMENT (or "-type comment) between last THEN clause and ELSE 
clause too long. 

20 through 29. Not used. 

30. A dependent retrieval level greater than 255 was requested. 255 
is assumed. 

31. A magnitude value greater than 32767 was specified in a magnitude 
specification. 32767 is assumed. 
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*40 OVER 10 NESTED CSWITCH BRACKETS. 
Nesting of CSWITCH brackets exceeded. 

41 ILLEGAL EXTERN MODIFIER 

Illegal or misplaced EXTREF, EXTDEF or LOCREF declaration. 

*42 END DECLARATION MISSING 

Missing program structure END- declaration. 

43 HEADER NOT RECOGNIZED 

Unrecognizable or illegal statement appearing in a header. 

* 44 END HEAD MISSING 

END-HEAD statement missing after major header. 

*45 FUNCTION RETURN MISSING 

Return statement missing from function. 

46 ILLEGAL EXIT PARAMETER 

Illegal name specified as a formal exit parameter. 

47 COMPOOL REQUEST IGNORED 

Requested COMPOOL generation run not made due to detection of SYS-PROC 
statement. 

48 INCOMPATIBLE DATAUNIT 

Expression operands do not conform to data unit type restrictions or do not fit 
context required by operator. 

* 50 NO DEF CHECK PERFORMED 

No structural compatibility checking between external compiler -packed table 
definitions. 
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51 FILE TYPE MISSING 

Type descriptor missing in file declaration. 

*52 CMS-2 BRACKET MISSING 

CMS-2 statement missing as terminator for a direct code block. 

53 VALUE SIGNIFICANCE LOST 

The most significant bits have been lost during alignment of a numeric constant 
used as a variable or field preset or a value block value. 

54 TOO MANY STATUS CONSTANT 

More than 12 status constants associated with a data unit. 

55 DUPLICATE ALLOCATION 

Symbol appears on the left of more than one EQUALS statement. 

56 ILLEGAL ALLOCATION 

Attempt to establish EQUALS allocation via a constant (absolute 
allocation) or illegal EQUALS expression. 

57 LIBS NOT DEFINED PRIOR 

Library selection statement appearing prior to a LIBS statement. 

58 nnnnnnnn NOT RETRIEVED 

The request element, named nnnnnnnn, was not found in any of the de- 
clared libraries. 

*59 FIELD LIST MISSING 

No fields specified for a compiler packed table. 

60 WRONG ARGUMENT COUNT 

Procedure call parameter list mismatched. 
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01 FORMAT NOT INDICATED 

Missing format statement reference in ENCODE/DECODE statement. 

02 WORD MORE THAN 12 CHARS 

Name, identifier, or symbol' more than 12 characters. 

(13 MUST RE FORMAT NAME 

Syntax requires name to be a format statement reference. 

' 01 WRONG END NAME 

Incorrect name on END- statement. 

05 SYNTAX 

Erroneous statement syntax or punctuation. 

GO COMPILER PROBLEM, SYNTAX 

Syntax of statement cannot be analyzed by compiler. 

'07 INCORRECT END KEYWORD 

Wrong END- bracket statement used. 

* G8 NO SYSTEM DECLARATION 

Missing SYSTEM declaration as first statement of source input. 

♦CO NO END-SYSTEM 

Missing END-SYSTEM statement 

*70 SYNTAX 

Syntax of statement not correct. 

+ 71 OPTIONS STMT MISSING 

Options statement missing from major header. Syntax diagnostics will be only 
output. 
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*72 PARA M PROCESSED AS VRBL 

Parameters are not allowed in function definitions. 

73 PROCEDURE I/O LIST ERROR 

Procedure call parameters do not match procedure definition. 

74 ILLEGAL KEY TYPE 

Key type not legal for this element. 

75 DUPLICATE KEY 

KEY previously declared. 

7(> ELEMENT KEY GREATER 4 CHS 

Library element key is greater than four characters. 

*77 MISPLACED STATEMENT 

A misplaced or extraneous END statement has been encountered at a point 
in the program where all VARY declarations and their END delimiters have 
been paired. 

*78 VALUE PRECISION LOST 

The least significant bits have been lost during alignment of a numeric constant 
used as a variable or field preset or as a value block value. 

79 ILLEGAL DECREMENT WITHIN 

Illegal VARY containing explicit FROM and WITHIN parameters with a 
negative BY parameter. 

*80 32D UNSIGNED DATA UNIT 

Variable is 32 bits unsigned (requiring 2 words). 
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81 ILLEGAL FORWARD REF 

Forward reference PROCEDURE and FUNCTION calls may not have STATUS 
constants as input or output parameters. 

82 TOO MANY PARAMS LISTED 

More parameters listed in call than specified in definition. 

*83 TRUNCATED TO INTEGER 

Scaled value has been truncated to an integer value where integer is syntactically 
required. 

84 MEANS OR EXCHANGE GT 132 

Character string in MEANS or EXCHANGE statement greater than 132 characters. 

85 NESTED MEANS OR EXCHANGE 

Referenced MEANS or EXCHANGE name contains another MEANS or EXCHANGE 
name in its substitution string. 

*86 NON-STRUCTURED STATEMENT 

The current statement violates CMS-2 structured programming conventions. 

*87 CONSTANT PRECISION LOST 

Precision bits of converted constant in the decimal range of 1E-24 to 1E-38 or 
the octal range of 1E-32 to 1E-52 have been lost. 

88 ILLEGAL EQUALS 

Illegal operator or operands in EQUALS expression. 

* 89 ILLEGAL LEVEL REQUEST 

LEVEL OPTION argument must be or 1. 

90 DUPLICATE REGISTER 

PARAMETER registers duplicated. 
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91 VARY VRBL IS THRU VALUE 

VARY loop index is the same data unit as the THRU clause data unit; 
hence, an illogical VARY statement. 

92 DEFINITION MISMATCH 

External definition or external reference does not match previous external 
definition or reference. 

93 DUPLICATE SYS-INDEX 

Definition of an index register as a system index which has already been 
declared as a system index. 

*94 IDENTIFIER EXTERNALIZED 

Local identifier definition which has been made global because of a 
previous external reference. 

95 STATUS CONSTANT GT 8 CHAR 

More than eight characters specified in a status constant. 

96 MONITOR CONTROL READ 

Missing TERMINATE statement; hence Compiler attempts to read a 
Monitor control card. 

97 TYPE NOT SPECIFIED 

A FOR -type was not specified for a FOR-expression which requires an 
explicit type specification. 

98 ERROR LIMIT EXCEEDED 

More than 100 syntax errors if options OBJECT requested or more than 
1000 syntax errors if options SOURCE requested. 
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99 DUPLICATE VALUE 

The same value was specified more than once for the same FOR block. 

100 VALUE MISSING * 

A value is not present on the BEGIN statement of a value block. 

101 VALUE BLOCK MISSING 

A BEGIN with associated value is not present following a FOR statement 
or a value block which is not the last value block of a FOR block. 

102 INCOMPATIBLE TYPE 

The type of an operand (numeric, Boolean, status, or Hollerith) is not 
compatible with its associated operator or operator. 

103 MISPLACED VALUE BLOCK 

A BEGIN with an associated value is present in a context other than 
immediately following a FOR statement or another value block. 

104 CONDITIONAL NOT BLOCKED 

A decision statement not enclosed within BEGIN-END brackets is 
present in the compound statement of another decision statement. 

{ 105 UNCOMPLETED CONDITIONAL 

The compound statement of a decision statement was not completed at 
the end of the containing block, procedure, or function. 

106 CONSTANT TRUNCATED 

The rightmost characters have been truncated during alignment 
of a Hollerith constant used as a variable or field preset or as a 
value block value. 
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107 ILLEGAL REGISTER 

A register other than through 7 was specified as a PARAMETER register. 

*109 NO END-CSWITCH xxxxxxxx 

Named CSWITCH does not have a corresponding END-CSWITCH bracket declara- 
tion. 

*110 NO CSWITCH FOR THIS END 

END-CSWITCH bracket declaration does not have corresponding CSWITCH bracket 
declaration. 
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Object Errors and Warning Messages (Warnings Flagged with *) . 

The following additional error messages may appear in a compilation which 

goes through the object code generation phase (OPTIONS OBJECT) : 

200 INCOMPATIBLE DATA TYPES 

Attempted assignment or comparison of incompatible data unit type. 

201 ILLEGAL OPERAND REF 

Operand reference illegal in context used in statement. 

*202 ABS OF UNSIGNED DATA 

Absolute value of unsigned data unit requested. 

203 DIRECT CODE SYNTAX ERROR 

Illegal or undefined operand, operator, or separator in a direct code 
statement. 

204 SYSTEM LIMIT nn EXCEEDED 

One of the following compiler limits denoted by nn has been exceeded. 
The code nn has the following values: 

20. The allocation table for generated labels has overflowed. A maxi- 
mum of 1000 generated labels per system procedure is allowed. 
This error may also occur for cases of more than 96 generated 
labels for a given procedure. 

21. Compiler use and allocation of temporary words have exceeded 
certain limits which, depending upon the distribution of tem- 
porary word usage and number of procedures, range from 2460 to 
3840 temporary words per system procedure. 

22. A maximum of 1536 binary constants can be generated per system 
procedure. 

23. A maximum of 4000 words of Hollerith constants can be generated 
per system procedure. 

24. A maximum of 4000 indirect words can be generated per system 
procedure. 
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205 REMAINDER NOT AVAILABLE 

SAVING remainder specified in statement without fixed-point division. 

206 STMT REQUIRES NONRT OPT. 

Run-Time call will be generated. This requires the NONRT (non-real time) 
option to be present. It is present by default if the MONITOR option is used. 

207 EXTERNAL DEF MISMATCH 

External reference does not match subsequent external definition. 

208 UNDEFINED IDENTIFIER 

Forward reference to an identifier which is not subsequently defined. 

209 SYSTEM ERROR 

Notify CMS-2Y maintenance personnel. 

210 COMPILER ERROR 

Compiler or undetected hardware error. 

211 TRANSREF IN P -SWITCH 

Illegal transient reference to procedure in a P-SWITCH, 

212 TOO MANY FRACTION DIGITS 

Too many fractional digits specified in a direct code constant. 

213 NON-NUMERIC CONSTANT 

Illegal constant or improper punctuation in a direct code statement. 

214 TOO MANY CHARACTERS 

Illegal MEANS or EXCHANGE character substitution in a direct code 
statement. 

215 ILLEGAL CHARACTER 

Illegal ASCII character appearing in a direct code statement. 
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216 UNRESOLVED EQUALS STMT 

Reference to an EQUALS tag which is not resolvable at the time of reference. 

217 ILLEGAL FORM PARAMETER 

Illegal parameter in a direct code FORM statement. 

218 FORM LABEL MISSING 

Label missing from direct code FORM statement. 

*219 RIGHT TERM TRUNCATED 

Truncation of operand has occurred. 

220 ILLEGAL SPECIAL COND 

Illegal STOP special condition specified on GOTO or RETURN statement. 

221 COMPILER PROBLEM, SYNTAX 

Syntax of statement cannot be analyzed by compiler. 

222 PARAMETER TRANSFER ERROR 

Statement results in alteration of contents currently held in PARAMETER 
register. 

Allocation Errors 

The following codes may appear on the output listing to flag allocation errors : 

A Allocation error. Reference to an undefined label or incorrect program 
allocation. 

C Compiler error. Incorrect instruction generation or undetected hardware 
error. 

Library Retrieval Errors, Messages and Operator Messages 
See paragraph 3. 4. 2. 3 and 3. 4. 2. 4 in Volume I. 
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Compiler Limits 

In addition to the various compiler limits given in the explanation of the pre- 
ceding error messages, the following limits are described here: 

Generated Indirect Words 

Compiler generated indirect words are locally defined within system procedures. 
A maximum of 4,000 indirect words can be generated per system procedure. These 
words are grouped into 100 blocks of 40 words per block. Within each block, 
all indirect words are unique. 

Generated Binary Constants 

Compiler generated binary constants are locally defined within system procedures. 
A maximum of 1,536 binary constants can be generated per system procedure. 
These constants are grouped into 32 blocks of 40 constants per block. Within 
each block, all constants are unique. 

Generated Hollerith Constants 

Compiler generated hollerith constants are locally defined within system pro- 
cedures. A maximum of 4,800 words of Hollerith constants can be generated per 
system procedure. These constants are grouped into 32 blocks of 150 constants 
per block. Within each block, all Hollerith character strings are unique. 

Identifiers 

The compiler dictionary for user defined identifiers contains a minimum of 10, 240 
words and a maximum of 32,768 words. The minimum sized dictionary is standard 
for a 49K AN/UYK-7 configuration. The number of dictionary words per identifier 
is variable depending upon type of identifier. The normal entry is six to nine words 
(see Table E-l). The dictionary is divided into a global segment and a local segment. 
Table overflow occurs whenever the size of the global segment plus the global hash 
table plus the largest local segment exceeds the size of the dictionary. The compila- 
tion is terminated at this point. 
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TABLE E-l DICTIONARY ENTRIES 
Types of Identifier Dictionary Entries Number of Words Per Entry 



1) 


abnormal exit name 


n = 5 


2) 


auto data name 


n = 7 


3) 


cswitch name 


n = 3 


4) 


data pool name 


n = 8 


5) 


display label 


n = 6 


6) 


equals name 


n = 5 + 2p 


7) 


dummy loop label 


n = 4 


8) 


exchange name 


rc+3~i 

n=5+ m 


9) 


field name 


n = 6 + 2s 


10) 


file name 


n = 8 + 2s 


11) 


for block 


n = 3 + 2s 


12) 


format name 


n = 7 


13) 


form label 


n= 7 


14) 


function name 


n = 7 + i 


15) 


header name 


n = 4 


16) 


index switch name 


n = 7 


17) 


item -area name 


n = 8 


18) 


item switch name 


n = 7 


19) 


like -table name 


n = 9 


20) 


local data name 


n = 7 


21) 


local index name 


n = 7 


22) 


local pool name 


n = 8 


23) 


major index name 


n = 8 


24) 


means name 


n = 5 + [— j 


25) 


nitems name 


n = 5 


26) 


procedure index switch name 


n = 7 + max(i, o) 


27) 


procedure item switch name 


n = 8 + max (i , o) 


28) 


procedure name 


n = 8 + max (i , o)e 


29) 


program base name 


n = 8 
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Type of Identifier Dictionary Entries 



Number of Words Per Entry 



30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 



ranged data name 
statement name 
sub -table name 
system data name 
system index name 
system name 
system procedure name 
table name 
table pool name 
value block 
variable name 



n 
n 
n 
n 
n 
n 
n 



n = 9 + d + t (1 + 2s) 
n = 8 
n = 5 

n = 7 + f + 2s 



Legend: 

c = number of characters is an integer such that [ C * 3 ] -^"4" 
d= zero for horizontal or vertical tables 

= number of dimensions for an array 
e = number of exit parameters 
f = 1 for fixed -point data 

= otherwise 
i = number of input parameters 
n = number of dictionary words per name 
o = number of output parameters 

p = number of names in the equals expression that are relocatable 
s - number of status constants 
t = 1 with table typing 
= without table typing 
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Generated Labels 

Compiler generated statement labels are locally defined within system procedures. 
A maximum of 1,000 generated labels per system procedure is allowed. Each 
procedure is limited to 128 generated labels; the worst case is 96 generated 
labels for a procedure that follows one with 32 or fewer generated labels. 
Whenever one of these limits is exceeded, the remaining generated labels assigned 
to the offending procedure or system procedure will be unallocated. 

Generated Temporary Words 

Compiler generated temporary words are locally defined within system procedures. 
A maximum of 32 blocks of temporary words can be generated per system procedure. 
The maximum number of temporary words per block is 120. The length and starting 
address of a temporary block is established at the end of a procedure if the 
number of reserved temporary words is at least 80 or at the end of the system 
procedure. The number of temporary words per procedure is at most 120 and 40 
for the worst case. Depending upon the distribution of temporary words and the 
number of procedures, the best case maximum number of temporary words per system 
procedure is 3,840, the worst case is 2,460. 

Cross Reference Errors 

*****C0MPLETE GLOBAL CROSS REFERENCE UNAVAILABLE — TOO MANY ELEMENTS***** 

Whenever the number of elements per compile is 160 or greater, a global 
cross reference cannot be produced. The local cross reference for each 
element will still be available and printed. The major header and all 
system data designs and system procedures are counted as elements; minor 
headers are not included in the element count since they are considered 
as part of the succeeding system element. 

*****L0CAL CROSS REFERENCE INCOMPLETE***** 

This message may appear at the end of a local cross reference listing. 
It indicates that the table for collecting reference data overflowed and 
no more references for that element were collected. 
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***#*ERROR ENCOUNTERED DURING CROSS REFERENCE DATA COLLECTION***** 

This message may appear at the end of a local cross reference listing. 
It indicates that an invalid condition was detected during cross 
reference data collection and was caused by a compiler error. 

*****TOO MANY IDENTIFIERS FOR SORTING -- NOT OUTPUT GIVEN***** 

This message informs the user that he will not receive his requested 
cross reference or symbol analysis output because there are too many 
identifiers for the compiler alphabetized identifier table. 

Tape Errors 

The user is notified of tape related errors detected during compilation. Error 
messages are provided on the standard hardcopy device and on the operator 
communication device. 

*****MAG TAPE ERROR UNIT Tn name 

This message is printed on the standard hardcopy device for any unre- 
coverable hardware errors or compiler detected checksum errors. Tn 
identifies the offending tape unit and the name identifies which com- 
piler output tape or compiler scratch tape encountered the error. The 
normal range of n in Tn is 1 through 8. The tape names are: compiler 
outputs, CCOMN, CSRCE, COBJT, CLIST; compiler SCRATCHm (internal com- 
piler scratch numbers m = 1 . . . , 4) ; and COMPOOL input (for COMPOOL 
and TO, the SEL-POOL request could not be satisfied; if Tn is a normal 
tape unit, a bonafide error was detected). 

*****COMPILE TERMINATED 

This companion message to the one above states that the tape error or 
the checksum error detected against one of the compiler scratch tapes 
necessitates termination of the compilation. 
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*****OUTPUT TERMINATED 

This companion message to the first one above states that the tape error 
detected against CCOMN, CSRCE, COBJT, CLIST, or COMPOOL necessitates 
that output to that tape be discontinued. Compilation and optional outputs to 
other tapes will be continued. 

*****WRITE ERROR Tn 

This message on the operator communication device informs the operator or 
user that an unrecoverable hardware error has been detected during a write 
operation to tape. Tn designates individual tape units Tl through T8. 

*****CHECKSUM ERROR Tn 

This message on the operator communication device informs the operator or 
user that an unrecoverable hardware error or a compiler detected checksum 
error has been detected during a read operation from tape. Tn designates 
individual tape units Tl through T8. (A TO tape designator may indicate a 
SEL-POOL request that could not be satisfied. The assigned tape number is 
not available to the compiler under such circumstances. ) 

Run-Time Errors 

The following error messages are printed by the run time programs during execution 
of the CMS-2 debug and high-level I/O operations. 

During a Debug DISPLAY or SNAP operation, the following error messages are printed 
in place of the expected results : 
** INVALID DATA REFERENCE ** 

An illegal data unit was referenced. Legal data units are an array, field, item, 

REGS, sub-table, table, and a word reference. 

** INVALID STATUS ** 

A data unit, with status attributes, has a status value without its corresponding 
status constant. 
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* + INVALID USE OF MAGNITUDE ** 

A magnitude -was specified on a non-numeric data element. 

Errors detected by the run-time high-level I/O operations are flagged by a one line 
location message and a one line description message. The run time abort message 
will repeat the location message. The location message has the following format: 

ERROR IN RTxxxx RTDSL AT yyyyyyyy LOGICAL UNIT zzzzzz. 

where RTxxxx - Name of run-time routine detecting the error. 

yyyyyyyy - Core address of the first entry in the Run-Time Data 

Specification List (RTDSL). 

zzzzzz - Hardware device name. 

The error description message, with its symptoms and disposition, are as follows: 
ALREADY OPEN 

A file was OPENed twice without an intervening CLOSE statement - job abort. 

RAD READ FOR FORMATTED INPUT 

An unrecoverable hardware error has invalidated the input data prior to 
internal conversion - job abort. 

BAD WRITE FOR FORMATTED OUTPUT 

An unrecoverable hardware error is detected while outputting a formatted 
message - job abort. 

BUFFER SMALLER THAN DATA UNIT 

The formatted buffer or source data unit is smaller than the decoded target 
unit during a DECODE or formatted INPUT operation - job abort. 

The cumulative character position counter of the converted data unit is 
larger than the literal buff er or target unit on an ENCODE or formatted 
OUTPUT operation - job abort. 
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DATA EXHAUST/END OF TAPE 

An End of Tape (EOT) mark has been detected on a previous INPUT or OUTPUT 
operation - job abort. 

END ITEM SMALLER THAN START ITEM 

A ranged data element specified by the form ((a) . . . (b)), has an ending item 
(b) smaller than the starting item (a) - only the starting entry is processed. 

ILLEGAL FORMAT SPECIFICATION 

Incompatible structure within the RTDSL's associated with the specified 
operation - job abort. Data is incompatible with format specification. 

ILLEGAL INPUT CHARACTERS 

Input characters for an I, E, and F format contains a character other than 
a "+", "blank", or a number through 9 - flush the target data unit 
with zeros. 

Number of octal characters (for a format) exceed 21 - flush the target data 
unit with zeros. 

LABEL INCORRECT 

The first record of a tape file doesn't match the specified label during a 
CHECKID operation - job abort. 

LOST FILE REFERENCE 

A file data unit specification wasn't located as the first entry in the parameter 
list associated with a file operation - job abort. 

NOT AT LOAD POINT 

A magnetic tape file was not at load point during a CHECKID or DEFID 
operation - job abort. 
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NOT OPEN 

A file operation was requested before the file was OPENed - job abort. 

NOT OPENED AS INPUT OR SCRATCH 

A file operation (CHECKID, INPUT, OUTPUT) was requested before the 
user-defined file was OPENed as an input or scratch file - job abort. 

NO AVAILABLE TAPES 

No available tape units remaining. 

NOT OPENED AS OUTPUT OR SCRATCH 

A file operation (DEFID, ENDFIL) was requested before the user-defined 
file was OPENed as an output or scratch file - job abort. 

OUTSIDE TAPE PHYSICAL FILE 

An End of Tape (EOT) mark was detected while positioning a file - job abort. 

OUTSIDE FILE BOUNDARY 

A file operation (INPUT, POS) was requested which either exceeds the 
number of records declared for that file or an EOT mark was detected - 
job abort. 

OUTPUT NUMBER TOO LARGE 

Number of converted characters exceeds the width specified by the format 
descriptor - flush the formatted target data unit with an ASCII character (*). 

PROGRAM TERMINATED BY RUN TIME IO 
Job abort message. 
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UNRECOVERABLE HARDWARE ERROR 

The monitor has detected an Unrecoverable Hardware Error (UHE). 

For a current unformatted INPUT or OUTPUT statement, processing will 
continue as normal with one exception. If a multiple read or a multiple write 
operation occurs as a result of a single INPUT or OUTPUT statement on a 
stream file, job abort will be invoked. 

Job abort will be invoked for all current formatted INPUT and OUTPUT 
operations, file and record positioning (FIL, POS). 

**** USER ERROR DISPLAY FLOATING POINT MAGNITUDE E+21 EXCEEDED 
Display table allows only E+21 characters to be displayed. 

**** USER ERROR MAGNITUDE E-22 EXCEEDED— TRUNCATION OCCURRED 
Display table allows only E-22 characters to be displayed. 
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SUMMARY OF ASSEMBLER ERROR CODES 

E Error Code 

Expression errors result from illogical expressions such as a decimal digit 
within an octal number; element type inconsistent with arithmetic operators; 
expression improper in context such as a GO line used outside a MACRO or a DO 
count in excess of 2^-1. 

D Error Code 

Duplicate errors result from labels defined more than once with different 
values. A label used in an expression affecting an address counter is not 
defined prior to its use resulting in a different addressing sequence in 
the first and second assembly passes. 

U Error Code 

An Undefined error results from a reference made to a label which is nowhere 
defined in the program. A reference is made to a label which was not ex- 
ternalized properly by a call, on a MACRO or by failure to suffix labels of 
MACRO entry points with an adequate number of asterisks. 

I Error Code 

An Instruction error results when the Assembler encounters: 

a) A MACRO or EQU directive which has no label. 

b) A SEGEND within a MACRO. 

c) More than one coded subfield in field zero of a MACRO 
reference line called via a MACRO name. 

d) A nested LIB directive or a LIB directive within a MACRO. 

e) A LIBS directive retrieved from a library. 

R Error Code 

A Relocation error results from an arithmetic or logical operation being 
performed on a relocatable value which destroyed its relocatabi lity . 

T Error Code 

A Truncation error occurs when the final value of an expression does not 
fit in the destined bit field of an object word. Therefore, the Assembler 
truncated the left-most bits of the value in order to make it fit the field. 
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Error Code 

The Overflow error occurs when memory available for the Assembler tables is 
exhausted. 

N Error Code 

A Name error occurs when the Assembler encounters a name which contains more 
than eight characters. 

L Error Code 

A Level error results from an expression containing a parentheses nest which 
is more than five deep; more than 64 SETADR lines have been encountered in 
this assembly. 

F Error Code 

A Floating Point error occurs under any of the following three circumstances: 

a) The divisor in. a requested floating point divide operation is zero. 

b) A floating point operation during evaluation of an expression yielded 
characteristic underflow. Characteristic underflow occurs whenever 
the characteristic is less than -32767. 

c) A floating point operation during evaluation of an expression resulted 
in characteristic overflow. Characteristic overflow occurs whenever 
the characteristic exceeds +32767. 

W Error Code 

A warning results when a label is used with a half-word instruction which is assigned 
to the lower half of a computer word. 

Library Retrieval Error Messages and Operator Messages 
See paragraphs 3.4.2.3 and 3.4.2.4 in Volume I. 

Other Assembler Error Messages 

See paragraphs 11. 10, 11.10.1, 11.10.2, 11.10.3 and 11. 10.4. 
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APPENDIX r. 
AN/UYK-7 CONDENSED REPERTOIRE 

Processor Instructions 



Function 


Mnemonic 


Ins true t i o n 


Description 


For- 


RPT PI 


CA 


Codes 












mat 






01 





OR 


a » y , b , s 


INCLUSIVE OR 


m© (a )-*a 

a a 


II 


X 


X 


01 


1 


SC 


a , y , b , s 


SELECTIVE CLEAR 


( Y) ' Q(A )-*A 
a a 


II 


X 


X 


01 


2 


MS 


a ,y , b, s 


SELECTIVE SUBSTITUTE 


(Y)-*(A ) for 

" a+1 n 

(A ) = 1 
a n 


II 


X 


x 


01 


3 


XOR 


a , y , b , s 


EXCLUSIVE OR 


(Y) (5 (A ) -♦A 
a a 


II 


X 


X 


01 


4 


ALP 


a.y.b.s 


ADD LOGICAL PRODUCT 


(A .) + (Y) Q(A ) 
a+l a 

-* A a+l 


II 


X 


x 


01 


5 


LLP 


a.y.b.s 




a a 


TT 
i 1 


v 
A 


Y 
A 


01 


b 


NLP 


a.y.b.s 


SUBTRACT LOGICAL PRODUCT 


(A a+1 ) - (Y)Q(A a ) 
-* A a+l 


II 


X 


X 


01 


7 


LLPN 


a.y.b.s 


LOAD LOGICAL PRODUCT NEXT 


(Y)OU)-*A a+1 


II 


X 


X 


02 





CNT 


a,y ,b,s 


COUNT ONES 


Count of ones in Y-f 
A 

a 

Y-*U; (P) unchanged 


II 


X 


X 


02 


2 


XR 


y ,b,s 


EXECUTE REMOTE 


II 






02 


3 


XRL 


y.b.s 


EXECUTE REMOTE LOWER 


Y L «* U; (P) unchanged 


II 






02 


4 


SLP 


a ,y , b , s 


STORE LOGICAL PRODUCT 


( V° ( W"* Y 


II 


X 


X 


02 


5 


SSUM 


a ,y,b,s 


STORE SUM 


(A) + (A ^,)-*Y 
a a+l 

and A a+1 ; (A )j ) i = 
( Vf 


II 


X 


X 


02 


6 


SDIF 


a.y.b.s 


STORE DIFFERENCE 


( W " ( V"* Y 
and A a+1 ; i^). = 

(A a ) f 


II 


X 


X 


02 


7 


DS 


a.v.b.s 


DOUBLE STORE A 


(A a+1 .A a ) Y+l. Y 


II 






03 





ROR 


a.y.b.s 


REPLACE INCLUSIVE OR 


(Y) © (A )-»Y and A 
a a 


II 


X 


X 


03 


1 


RSC 


a.y.b.s 


REPLACE SELECTIVE CLEAR 


(Y)' Q(A )-f Y and A 
a a 


II 


X 


X 


03 




RMS 


a.y.b.s 


REPLACE SELECTIVE 
SUBSTITUTE 


For (A ) = l.Y -+Y 
an — n 

and A . 
a+l 


TI 


X 


X 


03 


3 


RXOR 


a ,y ,b,s 


REPLACE EXCLUSIVE OR 


(Y) 0(A a ) -*Y and A 


II 


X 




03 


4 


RALP 


a.y.b.s 


REPLACE A+ LOGICAL PRODUCT 


(A .) + (Y) O (A ) II 
a+l a 


X 


X 












Y * nd A .+l 








03 


5 


RLP 


a.y.b.s 


REPLACE LOGICAL PRODUCT 


(Y) O (A) -*Y and A 
a a 


II 


X 


X 


03 


6 


RNLP 


a , y , b , s 


REPLACE A- LOGICAL 
PRODUCT 


(A .) - (Y) O (A ) 
a+l a 

YandA a+1 


II 


X 


X 


03 


7 


TSF 


y.b.s 


TEST AND SET FLAG 


Set CD; 1 -*Y 3l 


II 


X 
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Processor Instructions (Continued) 



Function 
Codes 


Mnemonic 


Instruction 


Description 


Format RPT PI CA 


05 





DL 


a ,y ,b, s 


DOUBLE LOAD A 


(Y + 1. Y)~ A -H .A B 


II 


05 


1 


OA 


a ,y ,b, s 


DOUBLE ADD A 


(Y + 1. Y) + (A a+1 . A,) - 
A A 


II 


05 


2 


DAN 


a.y.b.s 


DOUBLE SUBTRACT 


(A a+1 , A t ) - (Y + 1. Y) - 
A .+1'V 


II 


05 


3 


DC 


a ,y ,b, s 


DOUBLE COMPARE 


( W V : (y + l > Y): 

Set CD 


II 


05 


4 


LBMP 


a ,y ,b , s 


LOAD BASE AND MEMORY 
PROTFCTI ON 


Y - S : Y+l - SPR ; s - 
— a — a 

SIR, Y + (B D ) b - 
SIR a 15-0 


II 


06 





FA 


a ,y ,b , s 


FLOATING POINT ADD 


(A a+r A a ) *(T + liY)- 
A a+1' A a 


II 


06 


1 


FAN 


a .y ,b , s 


FLOATING POINT SUBTRACT 


(A a+1 . A a ) .« + !,«- 
A .T A a 


II 


06 


o 


FM 


a ,y ,b , s 


FLOATING POINT MULTIPLY 


(A. . A ) x (Y + 1 , Y) - 
a+1 a 

A , , , A 
a+1 a 


II 


06 


3 


FD 


a , y , b , s 


FLOATING POINT DIVIDE 


(A a+1 . A a )+ (Y + 1. Y) - 
A a+1' A a 


II 


06 


4 


FAR 


a .y ,b, s 


FLOATING POINT ADD WITH 
ROUND 


( A . A) + (Y + 1. Y) - 
a+1 a 

A , A ; round result 
a+1 a 


II 


06 


5 


FANR 


8 .y ,b , s 


FLOATING POINT SUBTRACT 
WITH. ROUND 


A , , , A_ ; round result 
a+1 a 


II 


06 


6 


FMR 


a , y , b , s 


FLOATING POINT MULTIPLY 
WITH ROUND 


(A„ , A ) x (Y + 1. Y) - 
a+i a 

A . , . A : round result 
a+1 a 


II 


06 


7 


FUR 


a ,y ,b, s 


FLOATING POINT DIVIDE 
WITH ROUND 


( A OJ ., . A ) -r (Y + 1 , Y) - 
a+1 a 

A . , . A : round result 
a+x a 


II 


07 





XS 


sy ,b 


ENTER EXECUTIVE STATE 


Interrupt to Executive 
Entrance Address 


II 


07 





I PI 


sy.b (a=l ) 


INTERPROCESSOR INTERRUPT 


Allow selective interrupts 
to other processors 


II X 


07 


1 


AEI 


a.sy.b 


ALLOW ENABLE INTERRUPT 


Enable Interrupt Request 

for IOC Channel Specified 
a 


II X 


07 


2 


PEI 


a , sy ,b 


PREVENT ENABLE INTERRUPT 


Disable Interrupt Request 
for IOC a Channel Specified 


II X 


07 
07 


3 
4 


LIM 

10 


a.sy.b 
a ,y ,b,s 


LOAD, LTJABLE IOC MONITOR 
CLOCK 

INITIATE INPUT/OUTPUT 


Y - IOC Monitor Clock 
a 

ADDR, Y=y + (B. ) + (S ) 
-IOC b 5 


II X 
II X 


07 


5 


JR 




INTERRUPT RETURN 


Return to Processor State 
designated by DSW 


II X 


07 


6 


RP 


a . sy ,b 


REPEAT 


Repeat NI (B7) times or 
until test condition is 
satisfied 


II 


JO 




LA 


a ,y , k,b, s 


LOAD A 




I X X 
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Funct ion 
Codes 


Mnemonic 


Instruction 


Description 


For- 
mat 


RPT 


PI CA 


1 1 


LXB 


a.y.k.b.s 


i nun a A Kin runrv o 
LOAD A AND INDEX D 


Y-»>A a ; (B b ) + 1-*^ 


1 




X 


12 


LDIF 


a ,y ,k , b, s 


LOAD DIFFERENCE (Y-A) 


Y - (A )-»A , 

- a a+1 


1 


X 


X 


13 


ANA 


a , y ,k , b , s 


ADD NEGATIVE A 


(A ) - Y-*A 
a — a 


1 


X 


X 


14 


AA 


a ,y ,k ,b,s 


ADD A 


(A ) + Y-e» A n 
a — a 


1 


X 


X 


If. 


LSUM 


a ,y ,k , b , s 


LOAD SUM (Y+A) 




1 


X 


X 


It) 


LNA 


a ,y ,k , b , s 


LOAD NEGATIVE 




1 


X 


X 


17 


LM 


a ,y ,k , b, s 


LOAD MAGNITUDE 




1 


X 


X 


20 


LB 


a ,y ,k ,b, s 


LOAD B 


Y-e»B 

~ a 


1 


X 


X 


21 


AB 


a ,y ,k ,b, s 


ADD B 


(B ) + Y-e>B 
a — a 


1 


X 


X 


22 


ANB 


a , y , k , b, s 


SUBTRACT B 


(B ) - Y-*B 

a - a 


1 


X 


X 


23 


SB 


a , y , k , b , s 


STORE B 


(B )-*• Y 
a 


1 


X 


X 


24 


SA 


a , y , k , b , s 


STORE A 


(A Y 
a 


1 


X 


X 


25 


SXB 


a, y.k.b.s 


STORE A AND INDEX B 


(A a )-»Y; (B,) + 1-^ 


1 




X 


26 


SNA 


a.y.k.b.s 


STORE NEGATIVE 


(A )' -a»Y 

a 


1 


X 


X 


27 


SM 


a ,y ,k ,b,s 


STORE MAGNITUDE 




1 


X 


X 


32 


BZ 


ak ,y ,b,s 


CLEAR BIT 


-a»Y_; (n = ak) 
n 




X 




33 


BS 


ak.y ,b,s 


SET BIT 


1 -»»Y ; (n = ak) 
n 


I 


X 




34 


RA 


a.y.k.b.s 


REPLACE ADD 


Y + (A ) -♦Y and A , 
- a a+1 




X 


X 


35 


RI 


a.y.k.b.s 


REPLACE INCREMENT 


Y + 1-»Y and A 

~ a 




X 


X 


36 


RAN 


a.y.k.b.s 


REPLACE SUBTRACT 


Y - (A )-»>Y and A , 

— a a+1 




X 


X 


37 


RO 


a ,y ,k , b.s 


REPLACE DECREMENT 


Y - 1-*Y and A 
- a 


1 


X 


X 


40 


M 


a.y.k.b.s 


MULTIPLY A 


Y x (A )-♦ A , . A 
- a a+1 a 




X 


X 


41 


D 


a.y.k.b.s 


DIVIDE A 


(A ., A ) * Y_*,A ; 
a+1 a * — ^ a 

Remainder A , 
a+1 




X 


x 


12 


BC 


ak , y ,b, s 


COMPARE BIT TO ZERO 


(Y) : 0; Set CD to equal 
n 

if (Yi - and non- 
n 

equal if (Y) ^ 0.(n=sk) 


/ 


X 




43 


CXI 


a , y , k , b , s 


COMPARE INDEX INCREMENT 


(B ) : Y i f (B ) > Y. 

a - a - 

0-*U. set CD to OL; if 

(B ) < Y. (B ) + 1-* B . 
a - a a 

set CD to WL 


T 


X 


X 


44 


C 


a.y.k.b.s 


COMPARE 


(A ) : Y; Set CD 
a - 


I 


X 


X 


45 


CL 


a.y.k.b.s 


COMPARE LIMITS 


(A ), (A ,) : Y; Set CD 
a a+1 - 


I 


X 


X 


46 


CM 


a.y.k.b.s 


COMPARE MASKED 


(A a+l ) : ( VO* ; Set CD 


I 


X 


X 


47 


CG 


a . y , k , b , s 


COMPARE GATED 


U- (A a'l = (A a+1) ; Set 
CD 


I 


X 


X 


50 


JEP 


a.y.k.b.s 


JUMP EVEN PARITY 


If (A- . ) O (A ) even, 
a+l a 

jump to Y; else NI 


III 
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Function 
Codes 




Mnemonic 


Instruction 


Description 


For- RPT PI CA 
mat 


sin 


i 
i 


JOP 


a.y.k ,b,s 


JUMP ODD PARITY 


If (A ') O (A ) odd, 
a+i a 

Jump to Jf; else NI 


III 


ou 


o 
c. 


DJZ 


a ,y ,k ,b, s 


DOUBLE JUMP A ZERO 


If (A a+1 . A a ) =0 
jump to Jf; else NI 


HI 




q 

o 


DJNZ 


a,y,k,b,s 


DOUBLE JUMP A NOT ZERO 


If (A A ) i 0, 
8+1 a 

Jump to Yj else NI 


III 


C 1 

D i 


A 
V 


JP 


a ,y ,k , b, s 


JUMP A POSITIVE 


If (A g ) i 0, Jump to Jf.; 
else NI 


III 


51 


1 


JN 


a ,y ,k , b,s 


JUMP A NEGATIVE 


If (A g )< 0, Jump to Y; 
else NI 


III 


51 


2 


JZ 


a , y ,k , b ,s 


JUMP A ZERO 


If (A ) = 0, jump to Y; 
else NI 


III 


51 


3 


JNZ 


a ,y ,k , b,s 


JUMP A NOT ZERO 


If (A a J r- 0, jump to Y; 
else NI 


III 


52 





LBJ 


a ,y,k ,b,s 


LOAD B AND JUMP 


(P)-* B a , jump to Jf 
(Y-* P) 


III 


52 


1 


JBNZ 


a,y,k ,b,s 


JUMP B NOT ZERO 


If (B ) > 0, (B ) - 1 
a a 

-•> B a> jump to Y; 
else NI 


III 


52 


2 


JS 


sy,k ,b 


JUMP SY + b 


Y = (B b )+sy 


III 


52 


3 


JL 


y,k,b,s 


JUMP LOWER 


Jump to Y_ Lower 


III 


53 





JNF 


y ,k ,b, s 


JUMP NO OVERFLOW 


If OD not set, jump to Jf; 
else NI 


III 


53 


01 


JNE 


y.k.b.s 


JUMP NOT EQUAL 


If CD set ^, jump to Y; 
else NI ~ 


III 


53 


10 


JOF 


y ,k , b, s 


JUMP OVERFLOW 


If OD set , jump to Jf_; 
else NI 


III 


53 


11 


JE 


y,k ,b,s 


JUMP EQUAL 


If CD .set =, jump to Jf; 
else NI 


III 


53 


21 


JG 


y.k.b.s 


JUMP GREATER THAN 


If CD set > , jump to Jf; 
else NI 


III 


53 


31 


JGE 


y .k.b.s 


JUMP GREATER THAN OR EQUAL 


If CD set t , Jump to Y; 
else NI 


III 


53 


41 


Tt T 


y , k , b , s 


TPMP I THAN 
J L fur Lloj inAft 


±l VsU act s , J unijj lu I, 

else NI 


III 


53 


51 


JLE 


y.k.b.s 


JUMP LESS THAN OR EQUAL 


If CD set < , jump to Y; 
else NI 


III 


53 


61 


JNW 


y.k.b.s 


JUMP NOT WITHIN LIMITS 


If CD set OL, Jump to Y; 
else NI 


III 


r.3 


71 


JW 


y ,k ,b,s 


JUMP WITHIN LIMITS 


If CD set WL, Jump to Y; 
else NI 


III 


53 


2 


RJ 


y ,k , b, s 


RETURN JUMP 


(P)-«*Jf, Y + 1 ~+P 


III 



(;-<i 
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Function 
Codes 


Mnemonic 


Instruction 


Descrlpt ion 


For- 
mat 


RPT 


PI CA 


53 

Jo 


2 

o 
c 


RJC 
d icr 


a,y,k,b,s 
a , y , k , b , s 


RETURN JUMP CONDITIONAL 
SETTING 

RETURN JUMP. STOP CON- 
DI TT ON AI SFTTING 


If Jump key, get, (P) 
Y + 1-*P; else NI 

(P) -*Y. Y + i-s>P; If 
stop key set, stop: 
else NI 8 


III 
III 




CD 




53 


3 


J 


y.k.b.s 


JUMP 


Y-*P 


III 






53 
53 
54 


3 
3 


JC 

JSC 

LCT 


a,y,k,b,s 
a , y , k , b , s 
ak ,y ,b,s 


JUMP CONDITIONAL SETTING 

JUMP. STOP CONDITIONAL 

SETTING 

LOAD TASK CMR 


If Jump g set , Jump to 
X; else NI 

Y-*»P; if Stop Key 8 set. 
stop; else NI 

Y -♦CMR 


III 
III 
I 


X 


CD 

fD 
x^ 

£> 


55 




LCI 


ak ,y ,b, s 


LOAD INTERRUPT CMR 


Y -^Interrupt CMR 


I 


X 


X 

g> 


56 




SCT 




STORE TASK CMR 


(CMR) -»»Y 


I 


X 


57 




SCI 


ak , y , b, s 


STORE INTERRUPT CMR 


(Interrupt CMR) -a»J[ 


I 


X 


X 

¥> 


hO 




HSCT 


af ..b 
4 


STORE TASK CMR IN A 


(CMR) A 

b 


IV-A 




60 
61 




HSCI 
HLCT 


af .,b 
4 

af .b 
4 


STORE INTERRUPT CMR IN A 
LOAD TASK CMR WITH A 


(Interrupt CMR) -t*A b 
(A b )-»»CMR 


IV-A 
IV-A 




X 

£> 


61 




HLCI 


af.b 
4 


LOAD INTERRUPT CMR WITH A 


(A b ) -»»Interrupt CMR 


IV-A 




X 


62 




HL<© 

HLC 

HLC 


a ,m 
a.b. 1 
a.b, 2 


SHIFT LEFT CIRCULARLY 


Shift (A ) left, end 
a 

around 


IV-B 






63 




HDLC® 

HDLC 

HDLC 


a ,m 
a.b. 1 
a ,b.2 


DOUBLE SHIFT LEFT 
CIRCULARLY 


Shift (A . . A.) left, 
a+l a 

end around 


IV-B 






64 




HRZ® 

HRZ 

HRZ 


a , m 
a.b, 1 
a,b.2 


SHIFT RIGHT FILL ZEROS 


Shift (A ) right, end off. IV-B 
zero fi 11 on left 






65 




HDRZ® 

HDRZ 

HDRZ 


a ,m 
a.b. 1 
a.b, 2 


DOUBLE SHIFT RIGHT FILL 
ZEROS 


Shift (A r A g ) right, 

end off, zero fill on 
left 


IV-B 






6b 




HRS^ 

HRS 

HRS 


3 m 
a.b.l 
a , b . 2 


SHIFT RIGHT FILL SIGN 


Shift (A ) riqht end off, 
a 

sign fi 1 1 on left 


IV-B 






67 




HDRS© 

HDRS 

HDRS 


a ,m 
a.b.l 
a.b. 2 


DOUBLE SHIFT RIGHT FILL 
SIGN' 


Shift <A , A ) right, 

end o'.'f , slqn- f i 1 1 on 
left 


IV-B 






70 





HSF 


a,b 


SCALE FACTOR 


Norma lire (A ) ; shift 

CO'. ■ * »v A 


IV-A 






70 


1 


HDSF 


a.b 


DOUBLE. SCALE FACTOR 


Norma il te ( A ,, H 1; 

a ■*• . a 

shift count -*A. 

b 


IV-* 






70 


2 


HCP 


a 


COMPLEMENT A 


! A 1 r 4 . 
a a 


IV-A 






70 


3 


HDCP 


a 


DOPBI E COMPLEMENT A 


(A . , A ') ' A , A 
a + 1 . a ^ s j 1 a 


IV-A 






71 





HOR 


a.b 


INCLUSIVE OR A 


( A ) © • A. ) -» A 
a v b a 


IV-A 







(T) Privileged instruction if 4 * a * 7 

Privileged instruction if 60. * af * 77 

^ „ , B 4 8' 



20 8 *» f 4 * 27 8 



(3) Shift instructions have three possible formats 
f • ,n> Cm is shift count ) 

f » ,b. 1 (shift count in B. ) 

D 

( ».b,2 ishift count in A^) 
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Processor Instructions (Continued) 



F unction 
Codes 




Mnemonic 


Instruction 


Description Format RPT 


PI CA 


71 


1 


HA 


»,b 


ADD (SUM) 


(A.) + (A. ) - A a 
a d a 


IV-A 




7] 


2 


HAN 


a.b 


SUBTRACT (DIFFERENCE) 


(A ) - (A.) - A 
a d a 


IV-A 




71 


3 


HXOR 


a.b 


EXCLUSIVE OR A 


(A < ) §(A b ) - A, 


IV-A 




71 


5 


HAND 


• ,b 


AND A 


(A a ) ©(A,) - A a 


IV-A 




74 





HM 


a ,b 


MULTIPLY REGISTER 


(A ) x (A. ) A . A 


IV-A 




74 


1 


HU 


a.b 


DIVIDE REGISTER 


(A . A ) * (A ) - A : 
l *a+r • ' b a* 

Remainder -• A_^, 
a+1 


IV-A 




74 


2 


HRT 


a.b 


SQUARE ROOT 


^ c Vr V - V 

Residue "* A^ + j 


IV-A 




74 


3 


HLB 


a,b 


LOAD B WITH B. 
a b 


( v- B . 


IV-A 




74 


4 


HC 


a.b 


COMPARE. REGISTER 


(A^ ): (A^) ; Set CD 


IV-A 




74 


5 


HCL 


a.b 


COMPARE LIMITS, 
REGISTER 


(A . + 1- V :(A b ): Set CD 


IV-A 




74 


6 


HCM 


a.b 


COMPARE MASKED. 
REGISTER 


(A >+1 )0(A a ):(A b ); 
Set CD 


IV-A 




74 


7 


HCB 


a.b 


COMPARE B WITH B. 

a d 


(B ): (B.); Set CD 
a d 


IV-A 




77 





HSIM 


a.b 


STORE I/O MONITOR CLOCK (IOC § Monitor Clock) - 1^ 


IV-A 


X 


77 


1 


HSTC 


a.b 


STORE REAL-TIME CLOCK 


(IOC a RTC) - 


IV-A 




77 


4 


HPI 




PREVENT CLASS III 
INTERRUPTS 


Lock out Class III 
Interrupts 


IV-A 


X 


77 


5 


HAI 




ALLOW CLASS III 
INTERRUPTS 


Allow Class III 
Interrupts 


IV-A 


X 


77 


6 


HALT 




STOP PROCESSOR 


Stop Processor Operations 


IV-A 


X 


77 


& 


HWFI 


i=l 


WAIT FOR INTERRUPT 


Stop referencing memory 
until interrupt occurs 


IV-A 


X 



Q Privileged instruction if 4 * a * 7. 

(2) Privileged instruction if 60 fl < af 4 * 77 Q . 20 fl * af 4 * 27 ( 

(3) Shift lastructions have three possible formats: 



f a.m (m is shift count) 

f s.b.l (shift count in B. ) 

b 

f a.b.2 (shift count in A^) 
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Fvt An c i on 

C>A l> ©II • A vll 


T net rupt i nm 

1 119 k 1 HVll Will 




Function 




Memonic 


Instruction 


Description Format 


RPT PI CA 


10 


ZA 


a 


CLEAR A 


- A. I 
• 


X 


«U 


CD 


8 


ct v ad n 




v 

A 


20 


N00P 




NO OPERATION (Full Word) 


- B I 




X 


23 


SZ 


y.k.b.s 


STORE ZEROS 


- Y I 


X 


7 A Q 


HNO 




INU UrfcHAllUN IH81X WOraJ 


lb J H tv-A 





c = 2 


IW 


y.b.s , 


INDIRECT WORD 






c - 1 


IWC 


y , w, p, b, s 


INDIRECT WORD CHARACTER 






c = 3 


IWCI 


y ,w, p, b, s 


INDIRECT WORD CHARACTER 












INCREMENT 






c = 0, 


IWS 


sy ,b 


INDIRECT WORD. SPECIAL 






bit 29=0 






BASE 






c = 0, 


IWB 


sy.b 


INDIRECT WORD. SPECIAL 






bit 29=1 






INDEX 








MP 


r , i , or , ow, ia , 


, i r 








HK 


e 


HALF-WORD CONSTANT 








BCW 


y.i 


BUFFER CONTROL WORD 








BCWE 


y . 1 .k 


BUFFER CONTROL WORD ESI 
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Input/Output Controller Instructions 


Function 


Mnemonic 


Instruction 


Description 


10 






IB 


J .y.k.c.m 


INITIATE INPUT BUFFER ON CJ 


Tnitiafi» 1 nnut Huff*T ah PI 

illj UB IC mUHk UMl (61 un V J 


11 






OB 


j , y ,k , c , m 


INITIATE OUTPUT BUFFER ON CJ 


Initiate output buffer on CJ 


12 






FB 




INITIATE EF BUFFER ON CJ 


Initiate EF buffer on CJ 


13 






XB 


j .y.k.c.m 


INITIATE EI BUFFER ON CJ 


Initiate FT buffer an n 

1111 llo IC CiX VHllcl Ull \s J 


14 


(k 


= 0) 


TIB 


J .c ,m 


TERMINATE INPUT BUFFER ON CJ 


Terminate output buffer on CJ 


1 -1 


l k 


- j ) 


TOB 


1 f m 


TERMINATE OUTPUT BUFFER ON Cj 


Terminate output buffer on CJ 


1 A 






Ten 


j . c , m 


TFRMTNATF FF R1TFFFB DN fM 


Ta ^ml Rita FF k> 1 1 f t m r Afl PI 

icrminaic cr ouiicr on 


1 4 


( k 


— O J 


TYR 
1 AD 


j i c , m 


TFBUTNATF FT RITFrpD nW PI 

l enrol IE. E.1 DUrrcK un CJ 


Terminate EI buffer on CJ 


15 


(k 


= 0) 


I MI R 


J • c 


REQUEST ON CJ 


Set input monitor interrupt 
request on Cj 


15 


(k 


= 1) 


0MIR 


j .c 


SET OUTPUT MONITOR INTERRUPT 
REQUEST ON Cj 


Set output monitor interrupt 
request on CJ 


15 


(k 


= 2) 


FMIR 


1 c 


SET EF MONITOR INTERRUPT 

. REQUEST ON Cj 


Set EF monitor interrupt request 

on Cj 


15 


(k 


- 3) 


XMIR 


j.c 


SET EI MONITOR INTERRUPT 
REQUEST ON Cj 


Set ESI monitor interrupt reques 
on CJ 


16 


(k 


= 0) 


AIC 


j . y . c 


ACTIVATE INPUT CHAIN ON CJ 


Activate input chain on CJ 


16 


(k 


= 1) 


AOC 


j • y . c 


ACTIVATE OUTPUT CHAIN ON CJ 


Activate output chain on CJ 


16 


(k 


= 2) 


AFC 


i . V . c 


ACTIVATE EF CHAIN ON CJ 


Activate EF chain on CJ 


xo 


< lr 


— o ) 


4 Yr 


j »y .c 


ACTIVATE EI CHAIN ON Cj 


Activate FT chain on Ci 


17 


(m 


= 0) 


TBZ 


fcj .y 


TFQT RTT n FARFn 


Tf l\\ — f) skin* NT 

kj 


17 


(m 


= 1) 


TBS 


kj.y 


TEST BIT SET 


If (Y). . 0, skip; else NI 


20 






JIO 


y.c 


JUMP (INPUT/OUTPUT) 


Y-a> Chain Pointer 


22 






LICM 


kj .y.c 


LOAD IOC CONTROL MEMORY 


(Y)-t»I0C Control Memory address 


23 






ILTC 


y.c 


LOAD REAL-TIME CLOCK 


(Y)-I»RTC 


24 






SICM 


kj.y.c 


STORE IOC CONTROL MEMORY 


(IOC Control Memory)^ _a>Y 


25 






IBS 


kj.y.c 


SET BIT 


^ Y kJ 


26 






IBZ 


kj.y.c 


CLEAR BIT 


°^ Y kJ 


27 






ITSF 


y.c 


TEST AND SET FLAG 


l-t>Y-.; if (Y)«. was originally 
cleared, skip; eMse NI 
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APPENDIX II 
CMS-2 SYSTEM TAPE DUPLICATION 
Additional copies of the CMS-2 system tape may be made by the following: 



Format 
$JOB 

$SYSMAKER 

ENDSYSBD 

$ENDJOB 

Explanation 

input name 



output name 



Example 



input name, output name 



One to eight character name of the system tape to 
be copied. To copy the system tape that is currently 
running, code the name CMS2SYST or leave this fir hi 
blank. 

One to eight character name of the tape on which the 
copy is to be written. If this field is not specified, 
the copy will be written on a tape named -NEWC0PTP. 



g£V.SiRAiKiE.fii 



i I i i I 1 I i I i I i i i i 1 



i i i i i i i i i 



I I I I I 



lft£MP3,0ig 



t i i 



i i i i i i i i i 



This would duplicate the system tape IN on to tape OUT 



H-l/H-2 Blank 
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APPENDIX I 
SYSTEM MODIFICATION 

1.1 INTRODUCTION 

There are two basic methods of modifying the data on a system tape using 
CMS-2. The first method uses the system tape generation control cards 
(described in paragraph 1.2) to completely reconstruct a system, including 
recompiling some of the components and adding new components. The second 
method uses system debugging aid cards (SPATCH described in paragraph 1.2.8 
to change individual instructions in specified component records each time 
the system loader loads the record from tape into memory. 

1.1*1 System Tape Organization 

Figure 1-1 illustrates the organization of a system tape generated by CMS-2. 
The first record on the tape contains the resident portion of the Monitor that 
the bootstrap routine loads into memory during system initiation. 

This first record also contains the resident system tape directory which 
identifies the physical position (by record number) of each segment directory. 
Each of these segment directories ident if ies which records make up the segment 
and where on the system tape (again by record number) each required record 
is located. The record data in memory is also called the compound address 
section with assigned base registers. 

The second record contains the segment directory for segment 2 in component 1. 
The following records contain the data for segment 2. The reader should note 
that the second tape record is the directory for segment 2 of component '1 
because this record is an exception to a basic organization assumption that 
the first segment directory on tape for a component is for segment 1 of the 
component. The first record on the tape is not assigned a segmen.t number 
because it never leaves memory; it is considered a part, of component 1 (the 
Monitor) . 
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Record Gap 
Record Gap 



ape motion 



RESIDENT MONITOR RECORD 
(Contains Resident Directory) 



COMPONENT 1 SEGMENT 2 
DIRECTORY 



COMP 1 SEG 2 RECORD 



COMP 1 SEG 2 RECORD 



etc . 



COMPONENT 1 SEGMENT N 
DIRECTORY 



COMPONENT 1 SEGMENT N 



'0, 



D, 



COMPONENT M SEGMENT 1 
DIRECTORY 



COMPONENT M SEGMENT 1 



'0, 



D s 



COMPONENT M SEGMENT N 
DIRECTORY 



COMPONENT M SEGMENT N 



SYSTEM LIBRARY 



-» Load Point Marker 
► Loaded into Memory by Bootstrap 
Routine 



Records Retrieved and Allocated 
►Memory When Retrieving Component 1 
Segment 2 



Tape Mark - End of Operation File 
Tape Mark 
Tape Mark 



Figure 1-1. System Tape Organization 
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Except for component. 1, the firsl segment in a component must be segment 1. 
There is no rule governing the physical arrangement, of the other segments 
in a component. They may be arranged in any order (normally to reduce; tape 
movement during operation) . Likewise, there is no rule governing the physical 
order of the components on the tape (except that the first component must be 
component 1) . 

A tape mark separates the operational file (containing the records for the 
segments in the system components) from the system library containing 
assembler procedures, compiler math routines, and so forth. 

Two tape marks appear at the end of the system library to indicate the end 
of recorded data. 

1.1.2 System Directories 

There are basically two system directories; the resident directory and the 
segment directory. The resident directory is loaded into memory during 
the bootstrap load. This directory contains a list of the components on the 
tape, and the location of each segment directory for each component. There 
is a segment directory on the tape for each segment in the system. The 
segment directory lists each record that must bo in memory before the segment 
can function properly. This list includes the physical location of the 
required records on tape. 

1.1.2.1 Resident Directory 

The resident directory has two basic parts: first, an introduction and list 
of components, and second, a list in physical component/segment order identi- 
fying the location of corresponding segment directories on the system tape. 
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The format of the resident directory is: 



31 



16 



Number of Components 



Tape Version 



System Tape Construction Date 



Counter 



Component Number 



Component Number 



Location of Seg List 



Location of Seg List 



Component Number 



Location of Seg List 



Number of Segments 



Segment Number 



Directory Position 



Directory Length 



Directory Checksum 



Segment Number 



Directory Position 



Directory Length 



Directory Checksum 



Introduction and 
Component List 



List of Segments 
in One Component 



Segment Number 



Directory Position 



Directory Length 



Directory Checksum 



Number of Segments 



Segment Number 



Directory Position 



Directory Length 



Directory Checksum 



etc. 



List of Segments 
in Next Component 
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Unless otherwise specified, all numbers are right-justified and all charncter 
strings are left-justified. 



Explanation 

Number of Components 



Tape Version 



System Tape Contruction 
Date 



Counter 



The number of system components currently on 
the tape. This value indicates the length of 
the component list. 

The 16-character system version or identifier 
specified on the first control card when the 
tape was generated. 

The eight-character date in the format MM/DD/YY 
supplied when system tape generation routine 
generated the system. MM = number of the month; 
DD = date; YY = last two digits of the year. 

Set to zero on BUILD and REPLACE functions. It 
is incremented by one on MOVE, DELETE, and PATCH 
functions. If multiple functions are specified, 
the first designated function determines change 
in counter value . 



Component Number An assigned number that is associated with 

process an independent processor. (Loader, 
Librarian, Sysmaker, etc.) 

Location of Segment List This is a pointer to the segment list of the 

component. The segment list is for the component 
that is in the same word as the pointer. 



Number of Segments 



Segment Number 



The number of segments that make up the corres- 
ponding component. This value indicates the 
length of the corresponding segment list (3 
words required for each segment and 1 word for 
the number of segments). 

As assigned number corresponding to a phase or 
pass of a given component. It is the collection 
of records of a component that are in core and 
executing at one time. 
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Directory Position 



Directory Length 
Directory Checksum 



The tape record number of the segment directory 
corresponding to the segment number in the same 
word. 

The length of that segment directory. 

The checksum (formed by executing full length 
fixed point adds disregarding overflow) of the 
segment directory data. 

NOTE 

At the end of each job, the CMS-2 Monitor 
prints the Tape Version, System Tape Con- 
struction Date, and Counter on the SYSTEM 
MEDIUM line. 



1.1.2.2 Segment Directory 



Each segment directory contains one word indicating the number of records that 
make up the segment plus a seven-word packet for each record. The packet con- 
tains the data used by the system loader to place the corresponding record in 
memory upon command. 

The format of the segment directory is: 



*t |H)|2t|XS]27|Z«|2S|Z4|2S|22|2l |ZO| lt|lt| 17 1 It 


l5|l4|iS|l2|ll|lO|»|a 


'!• 


S|4|S|2]||0 


Number of 


Records in Segment 


Component Number 


Record Type 


No. Linked Rec 


Record 
Name 


Record Position 


Initl Base leg 


Consec Base lee 


Memory Protection Code 


Number of Words 


Record Checksum 




Conl fig 


Component Number 


Record Type 


No 


Linked Rec 


Record 






Name 






Record Position 


Initl Base leg 


Consec Bise Fee 


Memory Protection Code 


Number of Words 


Record Checksum 




Cont Fig 



First Seven-Word 
Record Packet 



Second Seven-Word 
Record Packet 



etc . 
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Unless otherwise specified, all numbers are right-justified and all character 
strings are lef I -j ustif ied . 

Exp lanation 

Number of Records in The number of records that make up the 

Segment corresponding segment. This value indicates 

the number of record packets in the 
directory. 

Component Number The assigned number of the component l hat 

the record is a part of. 

Record Type One of the following codes that identifies 

the type of record: 

1 - fixed length data record. 

2 - fixed length instruction record. 

3 - dynamic variable length data record. 

4 - dynamic variable length instruction 

record. 

The Monitor permits dynamic record length 
adjustment requests (described in Systems 
Programmer's Manual paragraph 3.4.2) to ref- 
erence only type 3 or 4 records. 

No. Linked Records The number of tape blocks that are linked 

together to form a compound section or 
record. 

Record Name The up to eight-character name assigned 

to the record. The system routines 
reference the record using the assigned 
name. The name corresponds directly to 
the compound section name used on the 
object-code loader directives. 
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Record Position 



Initl Base Reg 



Consec Base Reg 



Memory Protect Code 



The relative position of associated record 
on tape (the first record after the load 
point is record 0) counting the segment 
directories as records. 

The number of the base register that the 
system load routine is to assign to the 
first 8K positions of the record. 

Indicates whether or not the system load 
routine is to assign consecutive base 
registers for each OK of memory as follows: 

1 - No; assign only one base register. 

2 - Yes 

An octal code that specifies what type of 
memory protection the System Load Routine 
is to set up for the record. It is a 
five-bit field. The operation is allowed 
if the bit is set. 



BIT NUMBER 


5 


4 


3 


2 


1 


TYPE 


I 


OR 


OW 


IA 


IR 



IR = 1 - Allows the use of interrupt 
index and base registers in 
indirect addressing. 



IA = 1 - Allows indirect addressing. 

OW = 1 - Allows operand writing. 

OR = 1 - Allows operand reading. 

I = 1 - Allows instruction execution. 
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Number of Words The number of memory words required I o hold 

the record data, l-'or dynamic records 
(variable lengths - types 3 and 4) this 
value indicates the initial length of the 
record. If this value is 0, there is no 
data on tape; however, the system load 
routine places the record name in the 
active record list and assigns memory 
space as the routine receives requests to 
expand the record length (see Systems Pro- 
grammer's Manual, paragraph 3.4.2). 

Record Checksum The checksum (formed by executing full- 

length, fixed-point adds disregarding 
overflow) of the specified record data. 

Cont Fig Two bits (bits and 1) indicating whether 

or not the record is the control record for 
the associated segment as follows: 

1 - indicates a control record. 

2 - indicates non-control record. 

When activating a segment, the Monitor 
passes control to the base address of the 
indicated control record. If more than 
one control record exists, control is 
given to the first one encountered in the 
segment directory. 

1.2 SYSTEM TAPE GENERATION 

System tape generation uses two routines; the system tape generation SYSMAKER 
routine (to process special cards required to prepare the resident directory 
and segment directories) and the object-code loader (to bind the routines). 
The SYSMAKER can build a system tape using only the special cards and loader 
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input. However, in normal operation, the SYSMAKER builds a new system tape 
by starting with data on an existing system tape, then changing and adding 
data, as commanded, to generate the new tape. 

The Monitor loads and transfers control to the SYSMAKER after processing a 
$SYSMAKER card (same format as the other component call cards; for example , the 
$SYSMAKER starts in column 1 with the rest of the card blank or having comments). 

The SYSMAKER performs the following five main functions: 

1. Build or insert function which adds a new segment or a new component, 
and new directory information. 

2. Replace function which adds a new version and deletes the old 
version of one segment at a time. 

3. Move function which changes the relative positions of a component 
or segment . 

4. Delete function which eliminates a component or segment. 

5. Patch function which inserts system patches. 

The routine scans the special control cards for one of the above functions. 
The first four functions must be declared in such an order that the current 
component upon which the operation is being performed has not been already 
copied by a previous function. The patch function must be a separate $SYSMAKER 
call. 

1.2.1 Build or Insert Function Cards 

The build or insert function cards command Lhe SYSMAKER to add a new 
component or a new segment to a component. The routine retrieves lhe resident 
directory and the corresponding segment directory from the input system I ape 
(if applicable). The def ini tions on the build cards are used to construct 
(or reconstruct) the resident directory and segment directories. The routine 
copies the data from the input tape (up to the position when the. defined 
segment or component is supposed to go) onto the scratch tape. 
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The SYSMAKER then cnlls the Loader to bind nil address sections. The 
lengths and other information passed from the Loader are placed into the 
segment directory tables. These bound sections (records) are placed on the 
scratch tape with the segment directory record first and the remaining 
records in the relative position declared with as many control records as 
are declared per segment. At this point, more segment builds, replaces, 
moves or deletions may be initiated. Upon the reading an ENUSYSBI) card, the 
scratch tape is file marked, and a new system tape is built containing the 
new resident directory information. The system library will be copied from 
the input system tape onto the output tape. For the case of an initial 
build, a null file with two tape marks will follow the operational li- 
brary. 

The following four cards are associated with the build or insert function: 

1. Initiate build. 

2. Segment definition. 

3. Record definition. 

4. Initiate Loader. 

1.2.1.1 Initiate Build Card 

The initiate build card commands the SYSMAKER to activate the build or 
insert function. One of these cards must be present for each component the 
programmer wishes to add to the system. The initiate build card defines the 
component the programmer wishes either to add to the system or to modify. 
Subsequent cards define individual segments in the component and records 
in the segments. 

Format 

BUILD output tape, comp no., asg name, comp position, input tape, 
mon loc, resdir offset, asg 2 name 
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Explanation 
Output Tape 



Gomp No. 



Asg Name 



Comp Position 



Input Tape 



The up to eight-character name of I ho 
output system tape the SYSMAKER is to 
use in the console messages. If this field 
is blank, the routine assumes the name 
NEWSYSTP . 

The number assigned to the component when 
it appears on the output tape. If this 
number is associated with a component on 
the input tape, the routine assumes that 
specified segments will be added to the 
component . 

A name or version up to four characters 
which the routine assigns to the new tape. 
This name appears in the second word of 
the resident directory. 

The number of the component on the input 
tape that is to immediately precede the 
component being processed. If this field 
is blank, the routine will place the 

component being processed either al the 
end of the output tape if the componenl 
is not on the input tape, or at the same 
relative position on the output as the 
component appears on the input tape. 

The up to eight-character name of the 
input tape the SYSMAKER is. to use in 
the console messages. If this field is 
blank, the routine will use the current 
system tape. A zero in this field specifies 
no input tape. 



1-12 



M-5035 

Change 2 



Mon Loo 



Resdir Offset 



Asg 2 Name 



The absolute octal address of the start 
of the Monitor boo Ls 1 raj) load area. the 
current Mon i 1 or is always loaded into I he 
upper area of memory. This value then 
specifies the bottom of the resident 
Monitor load area and the top address 
available to the non-resident, routines. 
If this field is blank, the routine assumes 
address 0. 

The offset from the beginning of the boot 
block (first jump cell) to the first 
address of the resident directory. If 
this field is blank, the input system 
tape offset will be assumed. 

A name or version up to eight characters 
which the routine assigns to the new tape. 
This name appears in the fourth and fifth 
words of the resident directory. The two 
assigned names are output upon completion 
of each job in the accounting summary. 



NOTE 



'Example 



The SYSMAKER uses the output tape, assign 
name, input tape, resdir offset, and 
Monitor octal load data on the first card 
processed after the $SYSMAKER card. The 
routine ignores these fields on subse- 
quent cards; therefore, these fields may 
be left blank. 



| 6iUiULiDi i iSiViSl»iSifei^i8ioiSiW|A|^hiAniSiyiSi6i3i4i^llil Hi6i*j*M i i 

On tape SYS036, prepare to insert a component with the number 0. Use 
tape SYS034 as the input system to be modified. Insert component fl 
immediately behind component 4. The resident monitor starts at 

address lll,000 o . 

<» 



_L_L 
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1.2.1.2 Segment Definition Card 

The segment definition card indicates the start of a segment record list 
for a specified segment within the component defined by an initiate build 
card . 

Forma t 

SEG segment number, segment position 
Explanation 

Segment Number The assigned segment number the segment 

being processed will have when it appears 
on the output tape. 

Segment Position The number of the segment within the 

component (specified by the initial 
build card) that is to immediately precede 
the segment being processed on tape. If 
this field is blank, the SYSMAKER places 
the segment at the end of the component 
or, if on the input tape, in the same rela- 
tive position. This field may not be used 

when "comp position" is used on the Build 

card. 

1.2.1.3 Record Definition Card 

There are two record definition cards. These cards contain the information 
required to construct the record packet in the segment directory. The two 
cards have the same format except for the card identifier. REC indicates a 
record definition card and CREC indicates a control record definition card. 

Format 
REC 

or record name, type, link base reg, mem protect code, length 

CREC 
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Kxp] anal ion 
Record Name 



Type 



Link Base Regs 



Mem Protect Code? 



The up U) e igh t -charac t er record name 
assigned to the record being processed. 
The specified data appears as llie record 
name in the corresponding record packet 
in the segment directory. 

A code lhat indicates 1 he type of record 
as follows: 

1 - fixed length data record. 

2 - fixed length instruction record. 

3 - variable length dynamic data record. 

4 - variable length dynamic instruction 

record . 

A code thai, indicates whether or not the 
system Loader is to assign consecutive base 
regislers for each OK 'portion of the 
record as f ol 1 ows : 

1 - No ( onl y one) . 

2 - Yes (default if not specified). 

An octal code that specific's what types 
of memory pro Lee lion I he Loader is to set 
up for the record; It is a five-bit field. 
The operation is allowed if the bit is set . 



Bi t Number 


f> 


4 


3 


2 


1 


Type 


I 


OR 


OW 


TA 


IK 



IR = 1 - Allows the use of interrupt 
index and base registers in 
indirect addressing. 



IA = 1 - Allows indirect addressing. 
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OW = 1 - Allows operand writing. 
OR =1 - Allows operand reading. 
I '= 1 - Allows instruction execution. 
NOTE 

If the memory protection code is not specified 
(default mode) , the SYSMAKER inserts a code 
of 36 for type 2 or 4 records (instruction 
records) or a code of 16 for type 1 or 3 
records (data records). 

Length A 1 indicates that the corresponding record 

has no initial length. The SYSMAKER 
puts no data on tape. The record name 
appears in the segment directory; and 
when the segment requests the Monitor to 
expand the record, the record is given 
space in memory (if dynamic). 

I .2.1.4 Loader Initiate Card 

The loader initiate card commands the SYSMAKER to transfer control to the 
Object Code Loader (described in Volume I, Section 3 of the User's Reference 
Manual). The cards following the Loader initiate card are inputs to the 
Object Code Loader until an END card appears. Then the Loader returns 
control to the SYSMAKER. 

Format 

LOAD counter release code 

Explanation 

Counter Release Code A code that informs the SYSMAKER whether 

or not the SYSMAKER is to use previously 
derived data during the current processing 
and whether or not the SYSMAKER is to save 
the data (such as bound data or linkage 
tables) as follows: 

Blank - Compute new tables as required 
and discard when finished. 
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1 - Save load information for next 

loader command. 

2 - Use load information generated by 

previous loader processing and save 
curreni load information for next 
loader command . 

15 - Use load information generated by 
previous loader processing and 
discard when finished. 

NOTE 

When a 2 or 3 is used, no loader 
directives or END card follow. 



1.2.1.5 Example Build or Insert Requests 



WfclTiaiWItflKitlKI 1 M l 1 1 1 1 1 1 1 1 I I I 1 1 1 1 1 

iBiU.IiLJ), i$iYiS*i3i7i>i8mSiViA,A/ 9i5i*iSiViSi*i3i6i9 


1 M 1 1 1 1 1 1 1 i i 
lrlili0iA4i i i i 1 i . 


iSidGi i ill i i i i i i i i i i i i i i i i i i 1 I 1 i i i I m i i i ii 


iCiRiEiCi iP|RjE|S S|£|Tm£|9i2|*|3|6 i i t i i i i i i 


1 1 II 1 M M 


ii 


iRiE|C, | iCiOiNiTUil^ili^iJifei ii i i i i i i i i i 


1 1 1 1 1 1 1 1 1 1 i i 


" |R|C|C t , J>,V,N,aK>i3i*i2i9|I|4| i ,1111111) 


1 1 1 1 1 1 M 1 


l l 


i^iOjAi^i Mil li iiiii i i i i i i i i i l i 


1 II 1 1 1 1 1 1 


ii 



Loader directives 



May have an object fleck 



-l*l"l"l 1 1 1 1 II 1 1 1 1 1 1 I 1 1 1 l 1 1 1 1 1 1 II 
1*1 Mil 1 1 1 1 I I 1 I 1 i i 1 I I I III 


1 IM M 1 1 1 

III 11 M If 


. . 
1 1 


iRiEiCi i iliffiBi(iFiii3i9i2i9i 1 i4ro jO i i i i i i i i i 


1 1 1 1 II 1 1 1 


i i 


i.C,R|6iC| iCi/»iRiDSiCiAiWi5.2i . ti i i i i i i • i i 


1 1 1 1 1 1 1 it i i 


iiiOiAiD t i i i i i i i i i i i i i 


i i ii i iii i 


i ll it ii II 


1 1 
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Loader diroctives 



May have an object deck 



1E1M1D1 i t i i i 1 i i i i i i i i i 1 i i i t • i i i i 1 i i i i i i i i i 1 i i 


iSfiGi 3i i i i i i i i i i i i i 


i i i i i i i i i 


i i i i i i i i i ii 


iRi e i c i iC|0,is/,Z|9 l|9|2, ill,,, , i i t i i i i i 


i i i i i i i i i ii 


iRiEiC, it ,/ iWi^oI^i^i /, i i i i i i i i i i i i i i i 


i i i i i i i i i 


i l 


|C|R|E|C| fP\R\0fi E|8'|S|9|2| , , , , 


i i i i i i i i i 


i i i 1 i I l i i 


i i 


,1i0iAi3, i i i i i i r i i i i i i 


i i i i i i i i i 


jiiiiiiii 


i i 



Loader directives 



May have an object deck 



ifiVlii Mini 


l I l I l I 1 1 1 1 


l I 1 1 1 1 I 1 1 1 1 1 1 


1 Mill I i 


iE|Wi2)iSiV,SiBiDi 1 


1 1 1 1 1 II 1 1 


i i i i I l i 1 i i i I 


him , ! 



The last card indicates the end of input to the SYSMAKER (see paragraph 
1.2.5). The above example effectively adds a new component (number 0) behind 
component 5 to the system on tape SYS036 and places the new system on tape 
SYS037. The new component consists of three segments. 
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3iS|V|S|fMiK|E ( fr| I i i i i i i i i i I i i i i i i i i i I 1 i i i i i i i 1 I i 
iBiUilil.Pi iSiV|S|»i3|g|fiy^,SilJ|/liW»,>.S,ViSiA3i7^il|lifi^iA Mill, 



iC,R,E,C, Ji/IiCiK 


| i i i i | i i i i i i i I i l 1 I i i l i i I i i 1 i i 


,R|E|C| iJid/Zi^io 2,111,1,1, i i i i i i i i i 


l l 1 1 I l 1 l 1 i i 


iR|E|C| iJiliMm 1\ i i i i i i | i 


i i i l 1 I i I i 


i l i I i i i i i 1 i i 


iRi£iCi HiMPiUiT 


01 i5j9j2i lil J 


i i i i i i i i i i i I l i i I i i 1 i i 


i L jOi AjDi iiii i i i i i i i I i 


1 i i 1 1 i 1 l 1 


l l l 1 1 l 1 I i 1 i i 



Loader directives 



May have an object deck 



iMlDl 1 1 1 1 I 


1 1 1 1 ! 1 1 I 1 


111 I 11 


i i i 1 i i i i 


i i i i l 




lE MPlSlY |*|8|*I 


! 1 I 1 1 I 1 I 1 


i i i i ii hi i i i i i i i i i 


I l 



The last, card indicates the end of input to the SYSMAKER. The above 
example effectively adds a new segment (number 4) to component on tape 
SYS037 and places the new system on tape SYS038. 

1.2.2 Replace Function 

The replace function is the process which replaces old segments with new 
ones. The new records of the segment retain all old directory information 
except length and possibly the initial base register. The old directory 
information is read into a table, after which the scratch tape is correctly 
positioned by copying everything up to the old segment. The Loader is called 
and returns the new records and their length information. The segment 
directory is updated and written on the scratch tape. Then the new records 
are written on the scratch tape, and the old segment is automatically deleted. 
Upon continued scanning, if ' an -ENDSYSBL) card is found, the scratch tape, is 
file marked, and the new system tape is made with the. new resident directory 
i nf ormat ion 

This function uses two cards: the initiate replace card and the initiate 
load card. Paragraphs 1.2.1.4 describes the format of the initiate load card. 
The format of the initiate replace card appears below. 
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Format 

REPLACE output tape, comp no,, seg no,, asg name, input tape, mon loc, 
resdir offset, asg 2 name. 



Explanat ion 
Output Tape 



Comp No. 
Seg No. 



Asg Name 



Input Tape 



Mon Loc 



The up to eight, character name of the 
output system tape that the SYSMAKER 
is to use in the console messages. If 
this field is blank, the routine assumes 
the name NEWSYSTP. 

The number assigned to the component that 
contains the data t( be replaced. 

The number assigned to the segment that 
the SYSMAKER is to replace with new 
data. 

An up to four character name or version 
the routine assigns to the new tape. This 
name appears in the second word of the 
resident directory. 

The up to eight character name of the 
input tape the SYSMAKER is to use in 
the console messages. If this field is 
blank, the routine will use the current 
system tape. 

The absolute octal address of the start of 
the Monitor bootstrap load area. The 
current Monitor is always booted into the 
upper area of memory. This value then 
specifies the bottom of the resident 
Monitor load area and the? top address 
available; to the non-resident, routines. 
If this field is blank, the routine 
assumes address 0. 
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The offset from the beginning of the hoot 
block (first, jump cell) to the first 
address of the resident directory. If 
this field is blank, the input system 
tape offset will be assumed. 

A name or version, up to eight characters, 
which the routine assigns to the new tape. 
This name appears in the fourth and fifth 
words of the resident directory. The two 
assigned names are output upon completion 
of each job in the accounting summary. 

NOTE 

The SYSMAKER uses the output. I ape, assign name, 
input tape, and Monilor octal load da I. a on tin? 
first card processed after the SYSMAKER card. 
The routine; ignores these fields on subsequent 
cards; therefore, these fields may be left blank. 

Example 

$iSiViSiftl/liK|Eifii I i i i i i i t | i 1 i i i i i I i i i i l i I i I I I l I 1 I I 

if?i£tP)LifliCiEi i IS.V, Si^^.o.Qi^.^l^.S.OJlAiA/.o.S.VtS^IB.e.^i / 1 1 .^,0i<^,<2i, 1 , , 
lliOi/hPi i I i I 1 i I i i i i i n I i i i i i i i i i l l i i i i i I i i I i i 

Loader directives 



May have an object, deck 



jEiAJiDi i i i i i 1 i i 


MINI 


1 I 1 l 1 1 1 1 1 1 1 1 


1 1 1 1 1 1 1 1 1 i i 


,E,NJ)iSiVfti8iDi 1 i i 


M I i I 1 


Mil 1 1 1 1 1 1 


1 1 1 1 II 1 1 1 i 1 
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The last card indicates the end of inputs to the SYSMAKER. The above 

example replaces segment 4 of component 8 on tape SYS038 with the data 

processed by the Loader. When complete, the routine writes a new system 
on tape SYS039. 

1.2.3 Move Function 

The move function changes the position of the specified component or segment 
on the system tape. First, it reads in the old resident directory information. 
The moved item is plpced in the delete table. Then the copy routine is called 
which positions the scratch with the old components copied on it. The defined 
item is then written onto the scratch tape, along with the correct tape 
position record numbers being placed in the segment directory. 

A move initiate card starts the move function. This card can command the 
SYSMAKER to change either the relative positions of the components in the 
system or the relative position of the segments wi thin various components. 
However, the rout ine cannot change the relative positions of segments within 
components that it has moved while changing the relative positions of 
components. Conversely, the routine cannot move components that are affected 
by commands to alter the relative positions of internal segments. 

Format 

MOVE output tape,comp no.,comp pos t seg no.,seg pos.asg name, input tape.mon loc 



Explanation 

Output Tape The up to eight character name of the out- 

put system tape the SYSMAKER is to use in 
console messages. If this field is 
blank, the routine assumes the name NEWSY ST P 

Comp No. The number assigned to the component that 

the SYSMAKER either is to move to a new 
relative position on the system tape or 
is to change the relative positions of its 
internal segments. 
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The number assigned to the component that 
is to immediately precede the component 
specified by the Comp Na field on the 
system tape., If this field is blank, the 
SYSMAKER assumes that the card changes 
the relative positions of segments within 
the component specified by the Comp No. 
field. If this field contains data, the 
Seg No. and Seg Pos field must contain 
blanks. 

The number assigned to the segment (of 
the component specified by the Comp No. 
field) that the SYSMAKER is to move to a 
new relative position on the system tape 
within the component. This field must be 
blank when the routine is to move the 
component containing the segment to a 
new relative position. If this field 
contains data, the Comp Pos field must be 
blank. 

The number assigned to the segment (within 
the component specified by the Comp No. 
field) that is to immediately precede the 
segment specified by the Seg No. field on 
the system tape. This field must be blank 
when the routine is to move the component 
containing the segments to a new relative 
position. If this field contains (lata, 
the Comp Pos field must be blank. 

An up to four character name or version 
the routine assigns to the new tape. This 
name appears in the second word of the 
resident directory. 
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Input Tape The up to eight character name of the input 

tape that the SYSMAKER is to use in the 
console messages. If this field is blank, 
the routine will use 1 he current system 
tape. 

Mon Loc The absolute octal address of the start. 

of the Monitor bootstrap load .area. The 
current Monitor is always booted into the 
upper area of memory. This value then 
specifies the bottom of the resident 
Monitor load area and the top address 
available to the non-resident routines'. 
If this field is blank, the routine 
assumes address 0. 

NOTE 

The SYSMAKER uses the output tape, assign 
name, input tape, and Monitor octal load 
data on the first card processed after the 
$SYSMAKER card. The routine ignores these 
fields on subsequent cards; therefore, these 
fields may be left blank. 

Examples 

MtViEi , B.ViSfll44»iS.».fl, »i?i»iSlkMiA/i»iSiViSifli3i9bil \\\2\Mi(t\ \ i 1 i » 

Move component number 5 to a position just behind component number 8. 
Notice thai fields Seg No. and Seg Fos are blank on this card as they 
must be for a move component command. 

|WiOiV.E. i .SiVi&,<fel^ 1 1 l ^i6 l ^n l 3 l ^rSi«IS.Ui,A,N i »iS l ViSi<h4l^i-»ili I i2i^iA^ I , 

Move segment 3 of component (> to a position just behind segment 
number 5. Notice that field Comp Pos is blank on this card as it must 
be for a move segment, command. 



1-24 



M-5035 
Change 5 



1.2.4 Delete Function 



The delete function prevents specified components or segments from appearing 
on the new system tape; thus, deleting them from the new system. The 
SYSMAKER, after processing an initiate delete card, removes all directory 
references to the specified component or segment. An initiate delete 
commands the routine either to remove an entire component or to remove one 
segment of a component . 

Format 

DELETE output tape, comp no. f seg no., asg name, input tape, mon loc f 
resdir offset, asg 2 name. 

Explanation 

Output Tape The up to eight character name of the output 

system tape the SYSMAKER is to use in the 
console messages. If this field is blank, 
the routine assumes the name NEWSYSTP. 

Comp No. The number assigned to the component that 

the SYSMAKER is to delete from the new 
system or the number of the component 
containing the segment that the SYSMAKER is 
• to delete from the new system* 

Seg No. The number of the segment within the 

component specified by the Comp No. field 
the SYSMAKER is to delete from the new 
system. If this field is blank, the 
routine deletes the entire component 
specified by the Comp No. field. 

Asg Name An up to four character name or version 

the routine assigns to the new tape. This 
name appears in the second word of the 
resident directory. 
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Input Tape The up to eight character name of the 

input tape the SYSMAKER is to use in 
the console messages. If this field is 
blank, the routine will use the current 
system tape. 

Mon Loc The absolute octal address of the start 

of the Monitor bootstrap load area. The 
current Monitor is always booted into the 
upper area of memory. This value then 
specifies the bottom of the resident 
Monitor load area and the top address 
available to the non-resident routines. 
If this field is blank, the routine 
assumes address 0. 

Resdir Offset The offset from the beginning of the boot 

block (first jump cell) to the first ad- 
dress of the resident directory. If this 
field is blank, the input system tape off- 
set will be assumed. 

Asg 2 Name A name or version, up to eight characters, 

which the routine assigns to the new tape. 
This name appears in the fourth and fifth 
words of the resident directory. The two 
assigned names are output upon completion 
of each job in the accounting summary. 



NOTE 

The SYSMAKER uses the output, tape, assign 
name, input tape, resdir offset, and Mon- 
itor octal load point on the first card 
processed after the $SYSMAKER card. The 
routine ignores these fields on subse- 
quent cards; therefore, these fields may 
be left blank. 
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1.2.5 End of Input 

The SYSMAKER continues to buijd a scratch tape containing all of the 
changes to the old system required to produce the new system until the 
routine processes an end of input card. The routine then copies the rest 
of the input tape onto the scratch and uses the accumulated change data to 
produce the new system. 

Format 

ENDSYSBD 

1.2.6 System Tape Patching 

The System Tape Patching routine reads system patch statement cards (see 
paragraph 1.2.8), processes system patch cards, and outputs a new system tape 
with all patches inserted. After the SYSMAKER reads the initiate patch card 
control is given to the System Tape Patching routine. This routine is inde- 
pendent of the other four SYSMAKER functions and cannot be used concurrently 
with them. 

Upon initiation of this routine, patch cards are read until a $ card is read. 
The patch information is stored during the reading phase. In the next phase, 
the System Tape Patching routine copies from the input tape, inserts the 
patches, and copies onto the scratch tape. In the final phase, this routine 
inserts the new resident directory into the Monitor while copying from the 
scratch tape to the output tape. 

The following control card initiates this routine: 
Format 

PATCH input tape, output tape 
Explanation 

Input Tape Up to eight-character name of the input 

tape the SYSMAKER is to use in console 
messages. If this field is left blank, 
the routine assumes the current system 
tape. 
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Output Tape Up to eight-character name of the system 

output tape the SYSMAKER is to use in con 
sole messages. If this field is blank, 
the routine assumes the name NEWPATTP. 

Asg Name An up to eight character name or version 

the routine assigns to the new tape. 
This name appears in the second and third 
words of the resident directory. 

Resdir Offset The offset from the beginning of the 

boot block (first jump cell) to the first 
address of the resident directory. If 
this field is blank, the input system 
tape offset will be assumed. 

Asg 2 Name A name or version up to eight characters 

which the routine assigns to the new tape, 
This name appears in the fourth and 
fifth words of the resident directory. 
The two assigned names are output upon 
completion of each job in the accounting 
summary. 

Mon Loc The absolute octal address of the start 

of the Monitor bootstrap load area. 
The current Monitor is always booted in- 
to the upper area of memory. This value 
then specifies the bottom of the resident 
Monitor load area and the top address 
available to non-resident routines. If 
this field is blank, the routine assumes 
address 0. 
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1.2.7 Copying System Tape 

The SYSMAKER duplicates a system tape when the $SYSMAKER control is followed 
by an ENUSYSBD card. The operation reads from an input system tape and writes 
on an output tape. 

Format 



ENDSYSBD 
Explanation 
Input Tape 



Output Tape 



Input Tape, Output Tape 

The up to eight character name of the input tape 
the SYSMAKER is to use in the console messages. 
If this field is blank, the routine will use the 
current system tape. 

The up to eight character name of the new copy of 
the system tape that the SYSMAKER is to use in the 
console messages. If this field is blank, the 
routine assumes the name NEWCOPTP. 

The SYSMAKER requests a scratch tape during the initialization phase and 
releases the scratch tape during the copy function. The operator may assign 
the output tape to the previously assigned scratch tape. Different output 
names must be declared for multiple copies in one job. A word-by-word 
comparison of the input tape and output tape can be made via the peripheral 
utilities compare function. 



1.2.8 System Patch 

The syslem patch control card calls the system .patch statement processor 
to process system patch statements that follow the specify system program 
cor'rection(s) . A patch statement must precede the load of tin? program being 
corrected . 
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Format 

$SPATCH 

Patch statement cards following the system patch control card contain the 
actual data. The statement processor modifies the specified component each 
time it is loaded into memory. Commas are used to separate all parameters. 
Spaces may be used to separate functional parts of a patch. Any number of 
consecutive spaces may surround the comma. No more than one starting location 
may be specified on one system patch statement. 

Format 

component, location, type, patch, patch... 

Each successive patch affects successive memory locations. 

Explanation 

Component A decimal number specifying one of the 

system components on the system tape. 

Location A location specified by a system record name 

(compound section name in a component 
of up to eight characters) followed by an 
optional octal or decimal increment, where 
a decimal value is followed by a D. This 
parameter specifies a starting location 
for a half-word or more of patch information, 

Type The patch statement type is as follows: 

I - Instruction 

K - I/O Controller command 

- Octal (a signed number consisting of 
up to eleven octal digits). 

C - Variable length Hollerith character 
string converted to ASCII. If the 
length of this character string is 
not a multiple of four characters, the 
last patched word will be filled on 
the right with space codes. 
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Information in a format determined by the patch type. 
Patch type formats include the following: 

1. Central Processor Instruction (I) 

The patch processor interprets the function 
code (FF) to determine the proper format. 
The patch processor considers all function 
codes legal. 

Non-assigned function codes 00 and 04 are 
treated as format n instructions, and non- 
assigned function codes 72, 73, and 75 are 
treated as format IV A instructions. 

As shown below, all full length instructions 
consist of octal digits. The first six digits 
are interpreted as FFAKBI, FFAF BI, or 
FFAF^BI, as applicable. The lower digits 
form SYYYYY. If there are less than twelve 
digits, the left six digits form the upper 
half of the word. The remaining digits form 
the S, Y, and SY fields, right -justified. 

Half-word instructions consist of six digits 
for each half-word. If only six digits are 
specified, the patch processor places the 
instruction in the upper half and all zeros 
in the lower half (a no-op). 
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The following list shows hardware 
formats and the corresponding 
coding sequence?: 

Hardware Formal Coding Sequence 



I FFAKBISYYYYY 

II FFAFo BISYYYYY 

III F F AF ^ KB I S Y Y Y Y Y 

F^K is coded as 
one oc t a 1 digit. 
I VA FFAF,BI 
IVB FFAF-MM (F r - V) 



FFAF-RBI 
.) 

FJi = A 

Shift count in Bj 
F r R = 6 

Shift count in A ( 

2. I/O Controller Commands (K) 

I/O Controller Commands are coded 
in one of two formats: 

Hardware Format Calling Sequence 

I (FF - 10-16) FFKJJMC YYYYYY 

II (FF = 17-20, FFKJMC YYYYYY 

22-27) 

Any function code (FF) not in the 
range 10 to 20, 22 to 27 shall be 
interpreted as a format I IOC 
command. 
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3. Octal (0) 

The patch statement processor 
accepts a leading plus or minus sign 
followed by as many as eleven octal 
digits. A valid octal number begin- 
ning with an octal digit is stored 
as coded. A leading minus sign 
causes the number following it io.be 
complemented (sevens complement) 
before storage. If fewer than 
eleven octal digits are coded, the 
resultant value is right-justified 
within the word (before complementing, 
if preceded by a minus sign) . 

4. Character (C) 

The patch statement processor 
accepts character strings containing 
graphic ASCII characters coded as 
f ol lows : 

(C C ...Cn) 

Where the desired variable length 
character string is enclosed in 
parentheses: Tf a right parenthesis 
is desired as part of the siring, 
it is necessary to code two for 
each right parenthesis wanted. 
The character string terminates 
with an odd number of consecutive' 
right parentheses. If .the-, 
character string does not resul 1 
in a number of characters which 
is an even multiple of four, the 
last word patched is filled on ihe 
right with ASCII space codes. 
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Kxamp hvs (system patch cards) 



I I 1 I I 1 I I I I I I I I I I I I I I I 1 I I I I I I I I I I I I I 



l,» |C,A l R l D l S,C,^ l ^,SiQ l o, I ,t , 1,0,3,010,0,0,00,7,^ 



I I I I I I I I I I l l I 



Change the ins true t ion loca ted in word 50^ of record CARUSCAN in 
component 1 to the inst ruction indicated (load A3 with a value of 7."^) . 



$iS|P|AtT|g|Hi i i I i i i i i i i i i 1 i i i i i 



I 1 1 1 I 1 I I I I I 1 l I 1 i 



'i i 1 1 i 



Change the character- string starting at word 500^ of record CARDSCAN 
in component 1 to the string indicated. This string occupies five 
words . 



$ | SiP|*|T | C,Hi 



M il 



h^iB | ^ i ^i p i^ i 7 | 7l6 | ^)i | ^|4 , 4 l 4 l 0,Q , 0|c) l 2 l S 



i i i i i i I i i i i i i i i i 



i i i 



Change the instruction located in word 776 of record RALPH in component 
1 to the instruction indicated (compare (A4l with a value of 25^). 
Because the lower digits describe a constant, all six digits are not 
required. 



I SiPiAiTiCiMi i i 1 i i i i i i i i i 1 i i i i I I I I l 1 l i i i l l I I I I t i i 


2.oiliWi9iOiAiTi*5 


4i3i0ili9i7,/iZ l /i3 


0. ,7iOi*i2,0|<5i*i 7i4i5i2i0iOi i n 


i i i 



Change the instructions located in words 543 and 544 of record INSORT 
in component 2 to the instructions indicated (half add (A2) + (A3) and 
complement (A4) instructions in word 543 with a square root (A5) instruc- 
tion followed by all zeros in word 544). The patch processor ignores the 
space between the two half-word instructions listed for word 543. 
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1.2.9 User Segment Addition and Execution 

User segments can be added to the utilities component of the system tape and subse- 
quently executed. A typical SYSMAKER run to add a utility segment might appear as 
follows: 

$JOB 

$SYSMAKER 

BUILD NEWTAPE, 3, XXLYY, ,OLDTAPE, 115000 
SEG 2 

RECDATAREC, U, 2, 36 
CREC INSTREC, 1, 2, 36 
LOAD 

DATAREC (1), SYSDD1, SYSDD2 
INSTREC (4), SYSPROC1, SYSPROC2 
LIBS CCOMN(REELNUM) 
SEL-ELEM 
END 

ENDSYSBD 
$END JOB 

The user's program is contained in records DATAREC and INSTREC. The five state- 
ments after LOAD are loader commands discussed in Section 3. The first two state- 
ments after LOAD are combine elements commands for the loader. 

To execute the added segment, the following sequence of operations may be used: 

$JOB 

Futility 

EXECUTE 2 
$ENDJOB 

Segment 2 is accessed in the execute with no return mode. Therefore, further 
utility commands may not follow the EXECUTE command. The user added segment 
is operating in the sytem mode, not the user mode, with all system facilities 
(such as those XS calls not available to a user program) available for use. 
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ABS, II-9-3 

ABS Directive, 11-11-21 

ABS Modifier, II-5-10 

Accessing the Compiler, II-7-1 

AC Directive, 1-3-12 

ACKN, 1-2-30, 1-2-31 

Active State Register, II-12-9 

Address Counter, 11-11-55 

Address Counter Declaration, 
11-11-53 

Allocated Map Listing, 1-3-36 

Allocation Header Statements, 
II -7-124 

AN/UYK-20 Loader, I-3A-1 

A Register, II-12-3 

Arithmetic Assignment State- 
ment, II -5- 27 

Arithmetic Expressions, II -5-1 

Arithmetic Operators, 11-11-64 

Assembler, 1-1-8, II-1-8 , II -11- 

Assembler Diagnostics, 11-11-76 

Assembler Outputs, 11-11-72 

Assembly Errors, 11-11-76 

AUTO-DD Declarative, II-4-1, 
II-4-7 



BASE, II-7-4, II-7-17 

BASE Directive, I-3A-3 

BC Directive, 1-3-18 

BEGIN Block, II-5-60 

BIT Modifier, II-5-10 

BKFILSKP, 1-5-6 

BKRECSKP, 1-5-7 

Blocks, II-5-59 

Boolean Assignment Statement, 
II-5-33 

Boolean Expressions, II-5-6 

BOOTWRT, 1-5-14 

BP Register, II-12-5 

B Register, II-12-3 

BYTE, II-9-3 

BYTE Directive, 11-11-21 
CARD-ID, II-9-2 
CARDTAPE, 1-5-12 
1 Card-to-Tape, 1-5-22 
CHAR, II-9-3 

CHAR Directive, 11-11-22 

CHAR Modifier, II-5-12 

Character Strings, II -9-8, 
11-11-60 



K-1 



M-5035 
Change 5 



CMS- 2 KEYWORD INDEX (contd) 



CHECKID, II -6-35 

CLOSE, II-6-26 

CMODE, II -7-4 , II-7-32 

CNT Modifier, II-5-13 

Combine Elements, 1-3-9 

Commands Available, 1-6-9 

COMMENTS, I I -11 -7 

COMPARE, 1-5-19 

Compare Tape, 1-5-24 

Compiler, 1-1-7, 1 1 -1-7 

Compiler Error Summary, II -10-12 

Compiler Outputs, II-10-1 

Compile-Time System Facilities, 
II-7-1 

Complex Macros, 11-11-52 

Compound Decision Statements, 
II-5-1 

Computer Instruction Repertoire, 
11-12-26 

Conditional Operators, 11-11-67 

Console Message Output, 1-1-9, 
1-2-63 

Constants, II-9-6, 11-11-59 

Control Declaratives, II -4-62 
DATA, II -4-61 
MODE, II-4-63 

Control Statements, II -5-41 



CONVERT, 1-5-15 

CORAD Modifier, 1 1 -5 -14 

CORRECT, II-7-4, II-7-25 

CPMCR Register, II-12-5 

Cross Reference Listing, 11-11 

CS Directive, 1-3-14, I-3A-2 

CSWITCH, II-7-4 

CSWITCH Brackets, II-7-30A 

CSWITCH Declarations, II-7-30 

CSWITCH-DEL, II-7-30B 

CSWITCH Deletion, II-7-30B 

CSWITCH-OFF, II -7 -4, II -7-30 

CSWITCH-ON, II-7-4, II-7-30 

Data Declarations, II -4-14 

END-TABLE, II-4-35 
FIELD, II-4-25 
ITEM-AREA, II-4-30 
LIKE-TABLE, II-4-34 
SUB-TABLE, II -4-31 
TABLE, II-4-19 
VRBL, I I -4- 15 

DATA Declarative, II-4-61 

Data Expressions, II -9-9 

Data Modes, 11-11-58 

DATAPOOL, II-7-4, II-7-18 

Data Referencing, II -4-44 

Data Words, 11-11-59 
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DEBUG, II -7-4 , II-7-29 

Debugging Aid Cards, 1-2-7, 

I- 2-18, 1-2-60 

Memory Dump Card ($DUMP) , 

1-2-18 
Patch Card ($ PATCH) , 

1-2-26 

Snap Card ($SNAP) , 1-2-21 

Debug Statements, II -8-1 

DISPLAY, II-8-2 
PTRACE, II-8-11 
RANGE, II-8-7 
SNAP, II-8-5 
TRACE, II-8-9 

Decimal Numbers, II -9-6, 

II- 11-56 

Decision Statements, II-5-45, 
II-5-50, II-5-54, II-5-55, 
II-5-58 

Declarative Statements, II -2-2 

DECODE St atememt, II -6-15 

DEFID, II-6-33 

DENSE, II-4-39 

DEP, II-7-4, II -7-25 

Device Identification Opera- 
tions, II-6-33, II-6-35 

CHECKID, II-6-35 
DEFID, II-6-33 

Device Positioning, II-6-28 

Device State Checking, II -6-26 



Direct Code, II-9-1 

ABS, II-9-3 
BYTE, II-9-3 
CARD-ID, II-9-2 
CHAR,. II-9-3 
DO, II-9-4 
FORM, II-9-4 
RES, II-9-4 

Direct Constant Entries, II -9- 

Directives, II-11-8, 11-11-21 

ABS, 11-11-21 
BYTE, 11-11-21 
CHAR, 11-11-22 
DO, 11-11-23 
ELIST, 11-11-32 
EMBED, 11-11-25 
END, 11-11-26 
EQU, II-11-26A 
EVEN, II-11-26B 
FORM, 11-11-27 
LCR, 11-11-28 
LIB, 11-11-29 
LIBS, 11-11-29 
LINK, 11-11-31 
LIST, 11-11-32 
LIT, 11-11-32 
LLT, 11-11-34 
NOLIST, 11-11-32 
ODD, II-11-26B 
PXL, 11-11-34 
RES, 11-11-35 
RF$, 11-11-35 
SEGEND, 11-11-36 
SETADR, 11-11-37 
WRD, 11-11-38 

DISMOUNT, 1-5-5 

Dismount Tape Message, 1-5-22 

DISPLAY, 1-2-61 
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DISPLAY Statement, 1 1 - 8 - 2 
DO, II-9-4 

DO Directive, 11-11-23 

Double Procedure Switch De- 
clarative, II-4-56 

DP Register II-12-6 

DSW Register ASR, II-12-6 

DSW Register ISC, II-12-6 

DUPLICATE, 1-5-10 

Duplicate (D) , 11-11-72 

Duplicate Tape, 1-5-22 

Dynamic Statements, II -2-2, 
II-5-1 

ELSE Statement, II-5-56 

ELIST Directive, 11-11-32 

EMBED Directive, 11-11-25 

ENCODE Statement, II -6-15 

END, 1-3-11, 11-11-39 

END-AUTO-DD Declarative, 
II-4-1, II-4-8 

END-CSWITCH, II-7-4 

END-CSWITCHS, II-7-4 

END Directive, 11-11-26 

ENDFILE, II-6-24 

END -FUNCTION Declarative, 
II-4-1, II-4-11 



END-HEAD, II-7-3 

END-HEAD Declarative, II-4-1, 
II-4-3 

END-LOC-DD Declarative ,11 -4 -1, 
II-4-7 

END-PROC Declarative, II-4-1, 
.11-4-8 

END Statement, II-5-60, II-5-67 

END-SYS-DD Declarative, II -4-1, 
II-4-4 

END-SYS-PROC Declarative, II-4-1 
II-4-13 

END- SYSTEM Declarative , 1 1-4 - 1 , 
II-4-14 

END-TABLE Declarative, II-4-35 
END VARY Statement, II-5-67 
EP Directive, 1-3-17 
EQUALS, II-7-4, II -7-19 
EQU Directive, II-11-26A 
Error Codes, 11-11-72 
ESI Mode, 11-12-17 
EVEN Directive, II-11-26B 
EXCHANGE, II -7-4 , II.-7-28 
EXEC Function, II-5-22 
EXECUTIVE, II-7-4, II-7-31 
Expression (E) , 11-11-72 
Expressions, I I -5- 2, 11-11-11 
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Expression Statements, 11-11-54 

EXTDEF Linkage, II-4-65 

Externalizing Labels, 11-11-50 

EXTREF Linkage, II-4-66 

Field, II-4-47, II-11-5 

FIELD Declarative, II-4-25 

FILE, II-6-20 

File and Record Position 
Determination, II-6-31 

File Search Operation, II-6-35 

SEARCH, II-6-36 

FIL Modifier, II-5-14 

FILSKP, 1-5-6 

FIND Statement, II -5-48 

Fixed Point Number, 11-11-58 

Floating Point (F) , 11-11-74 

Floating-Point Numbers, 
II-9-7, 11-11-57 

FOR Block, II-5-72, II -5-77 

FOR Statement, II -5-73 

FORCE, I-3-6A 

FORM, II-9-4 

Format I, 11-12-12 

Format II, 11-12-13 

Format III, 11-12-13 



Format IV-A, 11-12-14 

Format IV-B, 11-12-14 

FORMAT Statement, II -6-8 

FORM Directive, 11-11-27 

Full-word, 11-11-11 

Function Call, II-5-18 

EXEC, II-5-22 
RETURN, II-5-19 

FUNCTION Declarative, II-4-1, 
II-4-11 

Functional Modifiers, II-5-9 

ABS, II-5-10 
BIT, II-5-10 
CHAR, II-5-12 
CNT, II-5-13 
CORAD, II-5-14 
FIL, II-5-14 
LENGTH, II-5-15 
POS, II-5-15 

Generation Formats, 11-11-74 

Global Cross-Reference Listings 
II-10-5 

GO, 11-11-47 

GOTO Statement Name, II-5-41 

GOTO Switch Name Statement, 
II-5-42 

Half-word, 11-11-11 
HALT, 1-5-3 

Hardcopy Output, 1-1-9, 1-2-37 
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HEAD, II-7-3 

HEAD Declarative, II-4-1, 
II-4-2 

ICW Register, II-12-5 

ID Directive, 1-3-17 

Index Clause II -5- 64 

Index Procedure Switch De- 
clarative, II -4- 55 

Index Switch Declarative, 
II-4-50 

Indirect Word, 11-12-15 

Initial A-Register Values 
($AREG) , 1-2-16 

Initial B-Register Values 
($BREG), 1-2-16 

Initial Condition Cards, 
1-2-16 

Initial Hardware Setup, 
1-6-1 

Initiate Execution Cards, 

I- 2-17 

Jump Key Set Card 
($ KEYSET) , 1-2-17 

Transfer Control Card 
($TRA) , 1-2-18 

User Program Call Card 
($CALL) , 1-2-17 

Input/Output Statements, 

II- 6-1 

INPUT Statement, I I -6-4 



Instruction Expressions, II -9-13 

Instruction Formats, 11-12-12 

Instruction (I), 11-11-73 

Instruction Repertoire, II -12-1 

Interrupt, 1-2-7 

Interrupt State, II -12 -8 

I/O Command Formats, 11-12-16 

I/O Device Card, 1-2-12 

Item, II-4-45 

Item-Area, II-4-49 

ITEM-AREA Declarative, II-4-30 

Item Procedure Switch Declara- 
tive, II-4-58 

Item Switch Declarative, II -4-53 

Item-to-item Statement, II-5-36 

Job Definition Cards, 1-2-9 

End of Input Card ($EOI) 
1-2-12 

End of Job Card ($ENDJOB) , 
1-2-12 

I/O Control Cards ($ASG) , 
I/O Device Card, 1-2-12 

Job Limits Card ($JOB) , 
1-2-10 

Sequence Card ($SEQ) , 1-2-9 
LABEL, II-11-2 
Label Field, 11-11-15 
Labels, 11-11-16, 11-11-55 
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Wit Directive, II-U-28 

LENGTH Modifier, II -5-15 

Level 0, 11-11-75 

Level 1, 11-11-75 

Level (L), 11-11-74 

LIB Directive, 11-11-29 

Librarian, 1-1-7, 1-4-1, 
II-1-7 

Librarian Control Cards, 



Add Element (/ADD) , 
1-4-10 

Begin Element (/BEGINEL) , 

1-4-19 
Build New Library 

(/BUILD), 1-4-6 
Change Element Name 

(/CHANGE), 1-4-17 
Copy Elements (/COPY) , 

1-4-12 
Declare Dependent 

Elements (/DEP) , 

1-4-19 
Delete Elements (/DEL), 

1-4-15 
Delete Items (/D) , 

1-4-22 
Edit (/EDIT), 1-4-7 
End Corrections 

(/ENDCOR), 1-4-20 
End Element (/ENDEL) , 

1-4-19 
End Element Corrections 

(/END) , 1-4-21 
History Entry (/HISTENT) , 

1-4-9 
Insert Items (/I), 

1-4-21 
Librarian Terminate, 

(/ENDLIB) , 1-4-7 



List Job (/LIST), 1-4-6 
Start Corrections (/CORRECT) , 
1-4-20 

Start Element Corrections 

(/ELname), 1-4-20 
Tape Release (/RELEASE) , 

1-4-8 

Tape Select (/TAPID) , 
1-4-8 

Librarian Error Messages, 1-4-30 
Librarian Operator Messages, 



LIBS, 1-3-7, II-7-4, II-7-23 
LIBS Directive, 11-11-29 
LIKE-TABLE Declarative, II-4-34 
LINK Directive, 11-11-31 
Linking, 11-11-12 
List Options, II-7-8 
LIST Directive, 11-11-32 
LISTING, II-7-5, II-7-10 
Listing of Labels, 11-11-75 
LIT Directive, 11-11-32 
Literal Assignment Statement, 



Literal Expressions, II -5 -8 

Literals, II-9-11, 11-11-58 

LLT Directive, 11-11-34 

LLT Sample Listing, 11-11-75 

Loader Control Cards, 1-3-2, 
1-3-6 
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Combine Elements, 1-3-9 
Element Select (SEL-ELEM), 

1-3-8 
End (END), 1-3-11 
Library Select (LIBS) , 

1-3-7 

Table Size Declaration 
(TSD) , 1-3-7 

Loader Diagnostic Messages, 

I- 3-32 

Loader Directives, 1-3-12 

Address Counter Directive 
(AC), 1-3-12 

Binary Code Directive 
(BC) , 1-3-18 

Compound Section Direc- 
tive (CS) , 1-3-14 

End of Element Directive 
(EP) , 1-3-17 

Library Reference Direc- 
tive (LR) , 1-3-16 

Program Element Identifi- 
cation Directive (ID), 
1-3-17 

User Correction Direc- 
tive (UC), 1-3-26 

Loader Options Select, 
I-3-6A 

LOBJECT, I-3-6B 

Local Cross -Reference Listings, 

II- 10-4 

Local Indexes, II -4 -59 

LOC-DD Declarative, II-4-1, 
II-4-6 

LOCDDPOOL, II -7 -4, II -7-14 

LODGO, I-3-6B 

LOCREF Operator, II -4-67 



Logical Operators, 11-11-67 

Logical Statement, II -5 -46 

Loop Statements, II-5-50A 

LOPTIONS, I-3-6A 

LR Directive, 1-3-16 

MACRO, 11-11-39 

Macros, 11-11-10 

Macro Reference Lines, 11-11-52 

Macro Statements, 11-11-39 

Major and Minor Headers, II -7-3 

BASE, II-7-4, II-7-17 
CMODE, II-7-4, II -7-32 
CORRECT, 1 1 - 7 - 4 , II-7-25 
CSWITCH, II-7-4, II-7-30 
DATAPOOL, 11-7-4,11-7-18 
DEBUG, II-7-4, II -7-29 
DEP, II-7-4, II-7-25 
EQUALS, II-7-4, II-7-19 
END-HEAD, 1 1 -7 -3 
EXCHANGE, II-7-4, II - 7-28 
EXECUTIVE, II-7-4, II-7-31 
HEAD, II-7-3 
LIBS, 1 1 - 7 - 4 , II-7-23 
LISTING, II -7-5 , II-7-10 
LOCDDPOOL, II-7-4, II-7-14 
MEANS, II-7-4, II -7-27 
MONITOR, II -7-5 , II-7-11 
NITEMS, II-7-4, II-7-22 
OBJECT, II-7-5, II-7-7 
OPTIONS, II -7-4 , II-7-5 
SEL-ELEM, II-7-4, II-7-24 
SEL-HEAD, II-7-4, II -7-24 
SEL-POOL, II-7-4, II-7-24 
SEL-SYS, 1 1 - 7 - 4 , 1 1 - 7 - 2 4 
SOURCE, 1 1 - 7 - 5 , II-7-6 
SPILL, II-7-4, II -7-32 
SYS-INDEX, II-7-4, II -7-27 
TABLEPOOL, II -7-4, II-7-16 
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MEANS, II-7-4, II-7-27 
MEDIUM, II-4-38 

Miscellaneous Header Statements, 
II-7-27 

Mnemonics, 11-11-20 

Mnemonic Listing Format, 
II-4-63 

MODE Declarative, II-4-63 

MODEVRBL Option, II -7-12 

Modes of Operation II-12-8 

Monitor, 1-1-6, 1-2-1, II-1-6, 
II-7-5, II-7-11 

Monitor Control Cards, 1-2-2, 

I- 2-5, 1-2-8 

Monitor I/O, 1-2-5, 1-2-6 
Monitor Loader, 1-2-3 
MOUNT, 1-5-4 

Mount Tape Message, 1-5-21 

Multiword Assignment State- 
ment, II -5-35 

NAME, 11-11-45 

Name (N) , 11-11-73 

Nested Decision Statements, 

II- 5-58 

NITEMS, II-7-4, II-7-22 
NOID, I-3-6A 



Nolist Directive, 11-11-32 

NOMAP, I-3-6A 

NONE, II-4-38 

NONRT Option, II -7-12 

Nonstandard File Control, II -6-18 

CLOSE, II-6-26 
ENDFILE, II-6-24 
FILE, II-6-20 
OPEN, II-6-24 

Normal Mode, 11-12-16 

OBJECT, II-7-5, II -7-7 

Object Code Loader, 1-1-6, 1-3-1, 
II-1-6 

ODD Directive, 11-11-26 
OFF, II-11-14B 
OFO, II-11-14B 

Octal Numbers, II-9-7, 11-11-56 

OPEN, II-6-24 

Operand Field, 11-11-44 

Operation, 1-6-1 

Operation Field, 11-11-19 

Operator Communication, 1-3-36 

Operator Communication Cards, 
1-2-30 

Enter Executive State (XS) , 
1-2-32 
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Hardcopy Message ($ REMARK ) , 

I- 2-31 

Operator Message Cards, 1-5-2 

Dismount Tape (DISMOUNT) 
1-5-5 

Mount Tape (MOUNT), 1-5-4 
Operator Acknowledge 

(HALT) , 1-5-3 
Operator Information 

(TYPE) , 1-5-3 

Operator Priorities, 11-11-69 

Operators, 11-11-61 

OPTIONS, II-7-4 

OUTPUT Statement, I I -6-7 

Overflow (0) , 11-11-73 

OVERLAY, II-4-40 

Packing Rules, II-4-37 

DENSE, II -4-39 
MEDIUM, II-4-38 
NONE, II-4-38 
OVERLAY, II-4-40 

PACK Statement, II -5-40 

Paraforms, 11-11-40 

PARAMETER, II-4-18A 

Parenthetical Grouping, 

II- 11-70 

Parity Decision Statement, 
II-5-55 

PAUSE, 1-2-30, 1-2-31 



Peripheral Utilities, 1-1-7, 

I- 5-1 

Pooling Statements, II -7-12A 
Positioning by Files , II -6-28 
Positioning by Records, II-6-30 
Position Tape Cards, 1-5-5 

Rewind (REWIND) , 1-5-7 

Skip Backward Specified 
Number of Files 
(BKFILSKP), 1-5-6 

Skip Backward Specified 
Number of Records 
(BKRECSKP) , 1-5-7 

Skip Forward Specified 

Number of Files (FILSKP) , 
1-5-6 

Skip Forward Specified 
Number of Records 
(RECSKP) , 1-5-6 

POS Modifier, II-5-15 

P Register, II-12-2 

Procedure Call, II -5-16 

PROCEDURE Declarative, I I -4-1, 

II- 4-8 

Procedure Linking, 1 1 -5-15 

Procedure Switch Call, II-5-23 

Processing Conventions, II-9-15 

Program Structure Declaratives, 
II-4-1 

AUTO-DD, II-4-1, II -4-7 
END-AUTO-DD, II-4-1, II-4-8 



Performing the Bootstrap Load, 
1-6-3 
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END-FUNCTION, II-4-1, 

II-4-11 
END-HEAD, II-4-1, II--4-3 
END-LOC-DD, II-4-1, II-4-7 
END-PROC, II-4-1, II-4-8 
END-SYS-DD, II-4-1, II-4-4 
END-SYS-PROC, II-4-1, 

II-4-13 
END-SYSTEM, II-4-1, II-4-14 
FUNCTION, II-4-1, II-4-11 
HEAD, II-4-1, II -4-2 
LOC-DD, II-4-1, II-4-6 
PROCEDURE, II-4-1, II-4-8 
SYS-DD, II-4-1, II-4-4 
SYS-PROC, II-4-1, II-4-5 
SYS-PROC-REN, II-4-1, 

II-4-6 
SYSTEM, II-4-1, II-4-2 

Pseudo-operations (MACROS) , 
1-1-8 

P-SWITCH Declarative, II-4-55 

PTRACE, 1-2-61 

PTRACE Statement II -8-11 

PXL Directive, 11-11-34 

RANGE, 1-2-61 

RANGE Statement, II -8- 7 

READ, 1-5-17 

READ/Compare Tape Cards, 1-5-17 

Compare Tapes (COMPARE) , 
1-5-19 

Read into Memory (READ) , 
1-5-17 

READ to Cards or Printer 
(TAPEOUT) ,1-5-18 

Read Formatted Tape Record, 
1-5-23 



Record Length Determination, 
II-6-32 

RECSKP, 1-5-6 

REFORMAT, 1-5-11 

Reformat Tape 1-5-22 

Relational Expressions, 1 1 - 5 - 5 

Relocatability, 11-11-70 

Relocation (R) , 11-11-73 

Replacement Statements, II -5- 26 

RES, II-9-4 

RES Directive, 11-11-35 

RESUME Statement, II-5-66 

RETURN Function, II -5-19 

REWIND, 1-5-7 

RF$ Directive, 11-11-35 

SAVLODGO, I-3-6B 

Scaled Decimal Numbers, II -9-9 

Search Decision Statement, II -5-50 

SEGEND Directive, 11-11-36 

Segmentation, II -11-8 

SEL-ELEM, 1-3-8, II-7-4, II-7-24 

SEL-HEAD, II-7-4, II -7-24 

SEL-POOL, II-7-4, II-7-24 

SEL-SYS, II-7-4, II-7-24 

SETADR Directive, 11-11-37 
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SET Statement, II-5-26 

SHIFT Statement, II -5-39 

Side-by-Side Listing, 11-11-72 

Simple Statement, II -5-1 

Single Word- to-Multiword State- 
ment, II -5-36 

SIR Registers, II-12-7 

SNAP, 1-2-61 

SNAP Statement, II -8- 5 

SOURCE, II-7-5, II-7-6 

Source Deck Organization, 
11-11-79 

Source Listing Format, II-10-1 

Special Considerations, 
11-11-82 

SPILL, II-7-4, II-7-32 

SPR Registers, II-12-6 

S Register, II-12-3 

Standard Input, 1-1-9, 1-2-33 

Standard Output, 1-1-9, 1-2-35 

DISPLAY, 1-2-61 
PTRACE, 1-2-61 
RANGE, 1-2-61 
SNAP, 1-2-61 

Tape Assignment/Release, 

1-2-33, 1-2-49 
TRACE, 1-2-61 
Type Message ($TYPE) , 

1-2-30 

Type Message PAUSE (ACKN) 
($HALT), 1-2-30, 1-2-31 



Statements, II-11-5 

Statement Blocks, II-5-59 

Status Assignment Statement, 
II-5-32 

STOP Statement, II-5-45 

Subfields, 1 1 -11 -5 

SUB-TABLE Declarative, II-4-31 

SWAP Statement, 1 1 -5-38 

SWITCH Declarative, II-4-50 

Switch Referencing, ;II-4-59 

Symbol Analysis Format, II-10-6 

Symbol Definitions, 11-12-19 

Symbolic Conventions, 11-12-17 

Symbols, 11-11-62 

SYS-DD Declarative, II-4-1, 
II-4-4 

SYS-INDEX, II-7-4, II-7-27 

SYSMAKER, 1-2-15 

SYS-PROC Declarative, II-4-1, 
II-4-5 

SYS-PROC-REN Declarative, II -4-1 
II-4-6 

System (CMS-2), 1-1-3, 1-2-3, 
II-1-3 

System Component Call Cards, 
1-2-14 

Call Assembler ($ASM, U) , 
1-2-15 
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Call CMS-2 Compiler 

($CMS-2), 1-2-15 
Call Librarian 

($LIBEXEC), 1-2-15 
Call Peripheral Utility 

Routines ($UTILITY) , 

1-2-15 
Call Relocatable Object 

Code Loader ($LOAD), 

1-2-15 

SYSTEM Declarative, II-4-1, 
II-4-2 

System Linkage, II -4-64 

EXTDEF, II-4-65 
EXTREF, II -4-66 
TRANSREF, II-4-66 

System Messages, 1-6-14 

System Tape Generator, 1-1-8, 
II-1-8 

Table, I I -4 -44 

TABLE Declarative, II -4-19 

TABLEPOOL, II-7-4, II-7-16 

Table Search Statement, 
II-5-48 

Table- to-Table Statement, 
II-5-35 

TAPEOUT, 1-5-18 

Tape-to-Card or Printer, 
1-5-23 

Task State, II-12-8 
TRA Directive, I-3A-4 
TRACE, 1-2-61 



TRACE Statement, II -8-9 
Transfer Declaratives, II -4-50 

Double Procedure Switch, 

II-4-56 
Index Procedure Switch, 

II-4-55 
Index Switch, II -4-50 
Item Procedure Switch, 

II -4-58 
Item Switch, II-4-53 
P-SWITCH, II-4-55 
SWITCH, II-4-50 

TRANSREF Linkage, II -4-66 

Truncation (T) , 11-11-73 

TSD, 1-3-7 

Two-Level Diagnostics, 1 1 - 7 - 1 2 
TYPE, 1-5-3 

Type Message and Await Response 
1-5-21 

Type Operator Messages, 1-5-21 

UC Directive, 1-3-26 

ULTRA, 11-11-12 

Undefined Labels, 11-11-75 

Undefined (U) , 11-11-73 

UNTIL Clause, II -5-66 

User I/O Chains, 1-2-48 

User Program Execution Cards, 
1-2-15 

User Routine Execution, 1-5-27 
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Utility Control Cards, 1-5-2 
Validity Statement, II-5-48 
Value Block, II-5-76 
VARY Block, II-5-61, II-5-67 
VARY Statement, I I- 5-62 
VRBL Declarative, II-4-15 
Warning, 11-11-75 
WHILE Clause, II-5-65 
Whole Table, II-4-45 
WRD Directive, 11-11-38 
WRITE, 1-5-8 

Write Formatted Tape Record, 
1-5-22 

Write on Tape Cards, 1-5-8 

Convert to System Data 
Card (CONVERT) , 
1-5-15 

Duplicate Tape 

(DUPLICAT) , 1-5-10 

Reformat Tape 

(REFORMAT), 1-5-11 

Write End of File Mark 
(WRTFILMK) , 1-5-10 

Write from Memory 
(WRITE) , 1-5-8 

Write in Bootstrap For- 
mat (BOOTWRT), 1-5-14, 
1-5-23 

Write Tape from Cards 
(CARDTAPE), 1-5-12 

WRTFILMK, 1-5-10 



XS, 1-2-32 

$AREG, 1-2-16 

$ASG, 1-2-12 

$ASM, U, 1-2-15 

$BREG, 1-2-16 

$CALL, 1-2-17 

$CMS-2, 1-2-15 

$DUMP, 1-2-18 

$ END JOB , 1-2-12 

$EOI, 1-2-12 

$ FORTRAN , 1-2-15 

$HALT, 1-2-30, 1-2-31 

$J0B, 1-2-10 

$ KEYSET , 1-2-17 

$LDUYK-20, 1-2-15, I-3A-1 

$LIBEXEC, 1-2-15 

$ LOAD , 1-2-15 

$PATCH, 1-2-26 

$ REMARK, 1-2-31 

$SEQ, 1-2-19 

$SNAP, 1-2-21 

$SYSMAKER, 1-2-15 

$TRA, 1-2-18 
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$TYPE, 1-2-30 
$UTILITY, 1-2-15 
/ADD, 1-4-10 
/BEGINEL, 1-4-19 
/BUILD, 1-4-6 
/CHANGE, 1-4-17 
/COPY, 1-4-12 
/CORRECT, 1-4-20 
/D, 1-4-22 
/DEL, 1-4-15 
/DEP, 1-4-19 
/EDIT, 1-4-7 
/EL name, 1-4-20 
/END, 1-4-21 
/ENDCOR, 1-4-20 
/ENDEL, 1-4-19 
/ENDLIB, 1-4-7 
/HISTENT, 1-4-9 
/I, 1-4-21 
/LIST, 1-4-6 
/RELEASE, 1-4-8 
/TAPID, 1-4-8 



K-15/K-16 (Blank) 
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